【Hello AI 科技致善】给教师们减点压吧！用 SOLO 打造【教案格式调整神器】— 专注内容，不再为格式烦恼！
项目名称：MD2WD — 基于 Markdown 的教务文档智能排版转换系统
技术栈：Vue 3 + TypeScript + Vite + Element Plus + Pinia + FastAPI + python-docx
应用场景：教案生成与适配、教材排版、教学文档规范化（Markdown → 规范 Word 一键转换）
项目灵感：观察到教师在教案排版上耗费大量时间，陷入"重形式、轻内容"的结构性矛盾，而他们本该把精力放在教学设计、课程优化与教学研究上
在线体验：http://[2409:8c85:aa10:a35f:f931:23d7:8312:49a6]:8081
MD2WD
一、摘要
面向乡村教师及教育工作者群体，在教案编写、教材编写与教务文档规范化场景下，提供 Markdown 到规范 Word 文档的一键转换能力。
通过"Markdown 文档 + 转换规则"的核心模式，实现内容与样式的完全分离，搭配可视化规则编辑器 + 实时预览 + 系统预设规范，让教师专注教学内容而非排版细节。
目前经实际使用验证，可大幅缩短教案排版时间，显著减轻教师在格式调整上的负担。
二、真实场景与需求
（一）目标人群
本项目希望帮助 
广大乡村教师及教育工作者，尤其是需要在资源有限、教研渠道匮乏的条件下，按规范格式提交教案、教学计划、课程标准的教师群体。
乡村教师往往一人承担多门课程，备课与文档处理的双重压力尤为突出。
（二）痛点描述
教师在教学文档排版环节面临三大核心痛点：
1. 排版耗时巨大，严重挤占教学精力
一份教案涉及字体、字号、行距、缩进、对齐等大量格式设置，且每个章节都要重复操作。乡村教师每周需要提交多份教案，排版成为沉重的重复劳动。在教学任务密集、课程周期紧凑的背景下，教师需在内容撰写之外投入大量时间进行格式调整与排版校对，严重制约了其在教学设计、课程优化与教学研究等高价值环节的精力投入，造成"重形式、轻内容"的结构性矛盾。
2. 格式规范难以统一，文档类型多样且要求差异大
校内教学文档种类繁多（教案、教学计划、课程标准等），格式要求差异大且动态更新。虽有统一标准体系，但教师因理解偏差或模板版本混乱，难以精准适配，导致文档格式五花八门，严重制约管理标准化水平。乡村学校尤甚——不同学校、不同学科对教案格式要求各不相同，每次换格式都要从头调整，容易出现字体不统一、行距不一致等问题，教案被退回重排的情况频发。
3. 排版经验难以共享，优质资源无法沉淀
一位老教师摸索出了符合规范的排版方案，却无法方便地分享给其他教师。新入职教师又要从零开始踩坑，重复经历"排版—被退回—再排版"的循环。在乡村教育场景里，优质资源匮乏、教研渠道有限，教师往往需要在有限条件下承担更重的备课与教学任务。老师缺的不是热情，而是可复用的资源、可落地的方法和一个随时能响应的"搭把手"。
（三）现有做法与不足
现有做法 不足之处 手动在 Word 中排版 耗时长、易出错、格式不统一，每份教案重复劳动；字体不一致、段落间距异常、表格错位等问题频发，需大量人工干预 使用 Word 模板 模板格式固定，无法适配不同学校/学科要求；修改模板门槛高，版本混乱导致格式五花八门 复制旧教案修改内容 容易残留旧格式，章节结构可能不匹配新要求；转换结果往往格式固化，难以满足个性化需求
核心矛盾：现有方案无法从根本上实现"按需定制、一键生成"的高效模式，格式调整依赖重复性劳动，严重挤占教师用于教学设计与科研创新的时间资源。
三、作品介绍
MD2WD 是一款专为教育工作者打造的教务文档排版转换网页工具，以"简洁输入，规范输出"为核心理念，采用前端配置后端转化的前后端分离架构，实现了用户撰写内容与配置格式的完全分离。
教师无需安装任何软件，打开浏览器即可使用，让教案排版从繁琐的重复劳动变成一键完成的轻松体验。
（一）核心功能
1. 教案一键转换 — 专注内容，零门槛
针对教师"不会排版、不想排版"的核心痛点，系统内置 14 个标准章节的完整格式规范（仿宋_GB2312 字体、固定行距 20pt、首行缩进等），教师只需按 Markdown 语法填写教案内容，上传后一键即可生成规范 Word 文档，全程无需了解任何排版细节。同时提供标准教案模板和填写指南，新教师也能快速上手。
2. 可视化规则编辑器 — 配置情况一眼可见
采用三栏布局设计：左侧配置菜单 + 中间配置面板 + 右侧实时预览。涵盖默认样式、页面样式、标题样式、段落样式、列表样式、表格样式、图片样式、代码块样式、页码样式 9 大配置模块，覆盖文档排版全要素。配置修改后预览面板即时响应更新，页边距可视化标注，效果一目了然。
3. 规则共享与评价 — 经验复用，共建共享
教师可将自创排版规则设为公开，供其他教师直接调用，实现"一次配置、多次复用"；支持基于现有规则一键创建副本，快速适配不同学校/学科要求；5 星评分 + 文字评价机制建立规则质量的持续迭代反馈，配合收藏功能，让优质排版经验真正流动起来。
4. 批量转换 — 效率倍增
支持最多 10 个文件同时转换，适配教师多份教案并行处理的场景。部分文件失败时提供详细错误报告，不影响其他文件正常转换，大幅提升工作效率。
（二）使用流程
教师从打开网页到完成教案转换，只需 4 个关键步骤： 
- 打开网页：访问 MD2WD 系统，无需安装任何软件
- 准备内容：按 Markdown 语法编写教案（或使用系统提供的模板），支持纯文本或含图片的 ZIP 包
- 一键转换：上传文件 → 选择"教案转换"（或自定义规则）→ 点击“开始转换”系统自动处理
- 下载文档：获取生成的规范 Word 文档，直接提交或打印使用
全程 3-5 分钟完成，较传统手动排版效率显著提升。
（三）局限与未来优化
当前工具在以下场景中存在局限：复杂图文混排（如文字环绕图片）、特殊版式（如试卷分栏）、包含复杂宏或公式的文档暂不支持转换。
下一步优化计划：
- 上传预览与在线编辑：用户上传文件后，系统将自动生成源文件预览，并支持在线修改 Markdown 内容，确认无误后再发起转换，减少因源文件问题导致的返工。
- 转换结果预览：转换完成后，用户可在下载前预览生成的 Word 文档效果，确认格式与内容符合预期后再进行下载，避免反复转换调整。
四、SOLO 开发过程
本项目全程使用 TRAE SOLO 模式独立开发，从零搭建前后端完整系统。以下是关键开发节点：
（一）前端项目
1. 初始化分层设计
第一层：基础设施搭建
- 项目脚手架（Vite + Vue 3 + TypeScript）
- 分层架构设计（API → Service → Store → Composable → View）
- TypeScript 类型系统（RuleContent、ConversionTask 等核心数据模型）
- 路由配置与认证守卫
第二层：核心业务模块
- 文件上传与管理（拖拽上传、ZIP 包解析）
- 规则 CRUD（创建、编辑、删除、另存为）
- 转换任务管理（状态跟踪、批量处理）
第三层：复杂交互组件
- 规则编辑器（9 个配置子组件 + 实时预览）
- 教案专项功能（模板下载、一键转换）
第四层：优化与完善
- 代码重构（类型去重、架构优化）
- 用户体验提升（暗色模式、首次使用引导）
2. 重点攻坚最复杂的模块 — 规则编辑器
规则编辑器是整个项目中交互最复杂、配置项最多的模块，9 个配置组件 + 实时预览系统，全部由 SOLO 逐个生成：
- 先搭骨架：用 SOLO 生成三栏布局 + 配置菜单 + 预览面板的基础结构
- 逐个击破：每个配置组件（GlobalFontConfig、PageSetupConfig、TitleStyleConfig 等）独立生成，SOLO 自动处理表单绑定、数据校验、单位转换
- 实时预览：用 SOLO 实现配置变更 → 预览更新的响应式联动，包括页边距可视化、缩放控制、拖拽调整
- 字体继承机制：用 SOLO 设计并实现全局字体自动继承 + 手动覆盖标记的智能机制
SOLO 在复杂组件开发中的提效体现：
- 一个包含 20+ 表单项的配置组件，SOLO 约 3-5 分钟即可生成完整代码（含类型定义、表单验证、事件处理）
- 实时预览系统的响应式联动逻辑，SOLO 一次性生成，无需手动调试
（二）后端项目
1. 核心架构搭建
- 用 SOLO 设计 FastAPI 分层架构（API → Service → Model），实现规则管理、文件管理、转换任务等核心模块
- 配置 SQLAlchemy ORM 与 SQLite 本地持久化，支持规则、文件、转换记录、评分收藏等数据管理
- 实现 JWT 认证体系与 CORS 跨域配置，保障系统安全可控
2. 文档转换引擎
- 用 SOLO 实现 Markdown 到 Word 的双阶段解析渲染（Parser → Renderer），支持标题、段落、列表、表格、图片、代码块等全要素转换
- 集成 python-docx 库实现高保真 Word 输出，支持字体、字号、行距、缩进、页边距等 9 大配置维度
- 设计 ZIP 包解析流程，自动提取 Markdown 与图片资源，支持相对路径图片引用
3. 教案专项功能
- 用 SOLO 定义 14 个教案章节的完整格式规范常量
- 生成教案模板下载、填写指南弹窗、章节结构说明等辅助功能
- 实现教案转换记录的本地持久化管理
（三）SOLO 能力应用
在开发过程中，充分运用了 SOLO 的多项核心能力：
SOLO 能力 应用场景 效果 代码生成 组件、API、Store、类型定义 一个 20+ 表单项的配置组件 3-5 分钟完成 FastAPI 路由、Service、Pydantic 模型 一套完整 CRUD 接口 5 分钟内生成 架构设计 分层架构、模块划分 SOLO 自动生成符合 Vue 3 最佳实践的目录结构 后端分层架构（API/Service/Model） 自动设计符合 RESTful 规范的模块组织 问题诊断 类型错误、逻辑 bug 精准定位问题，给出修复方案 Python 类型注解、SQLAlchemy 关系定义 快速解决 ORM 模型与 Schema 不一致问题 代码重构 类型去重、组件拆分 自动识别重复代码并合并 后端代码优化、异常处理统一封装 提升代码健壮性与可维护性 文档生成 函数注释、README 自动生成中文函数级注释 API 接口文档、架构说明 自动生成 OpenAPI 规范与模块文档
（四）关键 Prompt
1. 规则编辑器三栏布局生成
Prompt: 创建一个规则编辑器页面，采用三栏布局：
- 左侧：配置菜单（9个菜单项，点击切换配置面板）
- 中间：配置面板（根据菜单项动态显示不同配置组件）
- 右侧：实时预览面板（模拟 A4 纸张，展示配置效果）
要求：支持预览面板宽度拖拽调整，缩放控制 30%-150%
2. 实时预览联动实现
Prompt: 实现规则配置与预览面板的实时联动：
- 当用户修改任何配置项时，预览面板立即更新
- 预览内容包含：标题（1-4级）、段落、列表、表格、图片、代码块、页码
- 页边距用虚线可视化标注，显示厘米数值
4. FastAPI 批量转换接口生成
Prompt: 创建一个批量文件转换接口：
- 支持最多 10 个文件同时提交，异步处理每个转换任务
- 使用 BackgroundTasks 实现后台执行，接口立即返回任务 ID 列表
- 每个任务独立跟踪状态（pending/processing/completed/failed），支持错误报告
5. SQLAlchemy 关联查询优化
Prompt: 优化规则列表查询，关联获取创建者名称和平均评分：
- 使用 SQLAlchemy join 关联 User 表获取 creator_name
- 使用 func.avg 和 func.count 计算评分统计
- 实现分页查询，支持按创建时间、收藏数、评分排序
3. 教案章节格式规范定义
Prompt: 定义一个教案转换规则，包含 14 个标准章节：
1.1 课目名称、1.2 授课时间...4.2 教后反思
每个章节配置：字体（仿宋_GB2312）、字号、行距（固定20pt）、首行缩进
导出为 TypeScript 常量，供系统预设规则使用
（五）踩过的坑与解决方案
坑 1：类型定义重复导致运行时错误
问题：`LoginResult` 类型同时定义在 `types/api.ts` 和 `api/modules/auth.ts` 中，且字段不一致，导致登录后用户信息解析错误。
解决：用 SOLO 进行代码重构，统一类型定义到 `types/api.ts`，其他文件通过 `import type` 引用。
坑 2：Element Plus 图标全局注册导致包体积膨胀
问题：最初在 `main.ts` 中全局注册所有 Element Plus 图标，打包后体积过大。
解决：用 SOLO 重构为按需导入模式，每个组件单独 `import` 需要的图标，包体积减少约 30%。
坑 3：表格行高设置过小导致内容溢出
问题：用户设置表格行高为固定值（如 0.5cm），但字体大小 + 行距 + 内边距超过了这个值，导致内容被截断。
解决：用 SOLO 实现动态最小行高计算，基于字体大小、行距倍数、内边距、边框宽度自动计算最小值，低于最小值时给出警告提示。
坑 4：Markdown 内联样式混合解析导致格式丢失
问题 ：一行文本中同时存在行内代码 `code` 和加粗 **bold** 时，原有逻辑先移除加粗标记再处理行内代码，导致加粗样式丢失。
解决：用 SOLO 设计统一的内联样式解析器，使用单一正则表达式同时匹配所有内联格式，解析结果返回统一的 (type, text) 元组列表，渲染器根据类型分别处理。
坑 5：转换任务的状态追踪与错误隔离
问题：批量转换时，一个文件失败不应影响其他文件。需要追踪每个任务的状态、错误信息，支持用户查询进度，同时避免数据库连接泄漏或任务堆积。
解决：用SOLO设计任务状态机与错误隔离机制，每个任务独立数据库事务，失败不影响其他任务；且具备清晰的状态机：pending → processing → completed/failed，便于查询反馈。
五、效果验证
（一）转换效果对比
转换前：教师手写 Markdown 教案（纯文本，无排版）
转换后：一键生成规范 Word 文档
（二）效率提升
操作 传统方式 使用 MD2WD 单份教案排版 5-20 分钟 3-5 分钟 格式调整（换规范） 5-60 分钟 1 分钟（切换规则） 排版经验传递 口头/截图，难以复用 一键分享规则 多份教案批量处理 逐份操作 最多 10 份同时转换
（三）核心价值
推动教学文档管理从"经验依赖"向"规则驱动"转型，让教师把时间还给教学，把排版交给规则。
时间是最稀缺的资源，尤其是在乡村教育场景下。MD2WD 的核心价值不是"又一个文档工具"，而是从根本上解决"重形式、轻内容"的结构性矛盾——教师专注教学内容、课程设计与教学研究，系统自动处理繁琐的排版细节。无论是教案、教学计划，还是课程标准，只需定义一次规则，即可批量生成规范文档。对于乡村教师而言，这意味着：
- 可复用的资源：预设规则 + 模板体系，开箱即用
- 可落地的方法：4 步完成转换，零排版知识门槛
- 随时响应的"搭把手"：可视化规则编辑器 + 实时预览，随时调整随时生效
用 SOLO，让 AI 帮教师把时间还给课堂。 