mmkk/START_GUIDE.md

Markdown编辑器启动指南

🚀 快速启动

方法1：使用一键启动脚本（推荐）

chmod +x start-fixed.sh
./start-fixed.sh

方法2：手动分步启动

1. 启动后端服务

cd backend

# 创建虚拟环境（首次运行）
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 启动服务
python app.py

2. 启动前端服务（新终端）

cd frontend

# 安装依赖（首次运行）
npm install --legacy-peer-deps

# 启动开发服务器
npm run dev

🔧 故障排除

常见问题及解决方案

1. 端口占用问题

如果端口被占用，可以修改端口：

# 后端端口
PORT=5001 python app.py

# 前端端口（在frontend/vite.config.ts中修改）

2. Python依赖问题

# 如果安装失败，尝试更新pip
python3 -m pip install --upgrade pip

# 重新安装依赖
pip install -r requirements.txt --force-reinstall

3. Node.js依赖问题

# 清理node_modules和package-lock.json
rm -rf node_modules package-lock.json

# 重新安装
npm install --legacy-peer-deps

4. 跨域问题

确保前端vite.config.ts中的代理配置正确：

proxy: {
  '/api': {
    target: 'http://localhost:5000',
    changeOrigin: true,
  }
}

📋 功能验证

启动后，请测试以下功能：

✅ 基础功能检查

• 访问 http://localhost:3000
• 左侧文件浏览器正常显示
• 中间编辑器可输入文本
• 右侧预览实时更新

✅ Markdown功能测试

• 输入 # 标题 查看标题渲染
• 输入 **粗体** 查看粗体显示
• 输入代码块 ```python print("hello") ```
• 输入数学公式 $E = mc^2$

✅ 文件操作测试

• 创建新文件（点击📄图标）
• 保存文件（Ctrl+S）
• 在文件浏览器中导航目录

✅ 正则表达式测试

• 按 Ctrl+Shift+F 打开正则工具
• 选择"Markdown标题"模式
• 点击测试查看匹配结果

🐛 调试信息

检查后端服务

curl http://localhost:5000/api/health
# 应返回 {"status":"healthy","service":"markdown-editor-api"}

检查文件系统

ls -la backend/workspace/

检查日志

• 后端日志：查看终端输出
• 前端日志：查看浏览器开发者工具

📱 浏览器支持

支持以下浏览器：

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+

🎯 快捷键

快捷键	功能
Ctrl+N	新建文件
Ctrl+S	保存文件
Ctrl+Shift+F	打开正则工具
Ctrl+B	粗体
Ctrl+I	斜体
Ctrl+K	插入链接

📞 技术支持

如果遇到问题，请：

1. 检查终端输出中的错误信息
2. 确认端口未被占用
3. 验证依赖是否正确安装
4. 查看浏览器开发者工具中的网络请求