1. 培训教材生产的真实困境与破局思路
做培训讲师这些年，最头疼的从来不是站在讲台上讲课，而是台下那些看不见的准备工作。尤其是理工科方向的培训，公式教材的编写和配套习题的出题，几乎占据了我60%以上的备课时间。一份30页的公式讲义，从Word里敲公式、调格式、排版，到后面出练习题、做答案、生成解析，来来回回折腾一周是常态。更别提课程迭代的时候，公式要改、题目要换、答案要重新校对，那种重复劳动带来的消耗感，相信每个做过教材的同行都深有体会。
我一直在找一套能真正把这件事跑通的方案。核心诉求其实很明确：公式要能高效输入和渲染，教材要能结构化沉淀，出题要能自动化或半自动化，整个流程要能复用、能迭代。试过不少组合，最后稳定下来的工作流是WorkBuddy + Obsidian这套搭配，中间用MarkItDown做格式转换，公式部分统一走LaTeX语法，最终以Markdown作为底层存储格式。这套方案跑了大半年，教材编写效率大概提升了3倍，出题环节从原来的一天出20道变成了一天能出80到100道，而且质量更稳定。
这篇文章我会把这套工作流的每个环节拆开讲清楚。不管你是做K12辅导、职业培训还是企业内训，只要涉及公式类教材和习题生产，这套思路都能直接抄作业。零基础也能跟上，我会把每个工具的安装、配置、使用细节都写明白，包括我踩过的坑和绕过的弯路。
2. 工具选型背后的逻辑与整体架构
2.1 为什么是WorkBuddy加Obsidian这个组合
先说Obsidian。它的核心价值在于本地Markdown文件管理加双向链接。培训教材天然是结构化的知识体系，章节之间、知识点之间、题目和答案之间都存在关联。Obsidian的库（Vault）本质上就是一个文件夹，里面全是.md文件，每个文件就是一个知识点或一道题。这种扁平化结构带来的好处是：你可以用任何文本编辑器打开，可以用Git做版本管理，可以用脚本批量处理，完全不被某个平台绑架。
再说WorkBuddy。这是一个AI智能体工作台，核心能力是通过Skill机制把重复性任务自动化。我主要用它做三件事：一是把网页上的参考资料自动转成Markdown格式保存到Obsidian库；二是根据知识点自动生成练习题和解析；三是批量处理公式格式转换。它的Agent能力可以理解上下文，按照我预设的模板和规则来输出内容，而不是那种机械的模板填充。
MarkItDown是微软开源的一个文档转换工具，支持把PDF、Word、PPT、Excel等格式转成Markdown。我主要用它来处理手头的旧教材和参考资料，把Word里的公式和内容一次性转成Markdown格式，省去手动重敲的功夫。LaTeX则是公式表达的标准，Obsidian配合MathJax插件可以直接渲染LaTeX公式，写出来的公式既能在Obsidian里预览，又能导出成PDF或Word。
2.2 整体工作流的架构设计
整套流程我把它分成四个阶段，每个阶段有明确的输入和输出：
| 阶段 | 输入 | 处理工具 | 输出 |
|---|---|---|---|
| 素材采集 | 网页、PDF、Word文档 | WorkBuddy + MarkItDown | Markdown格式的原始素材 |
| 教材编写 | 原始素材、知识点大纲 | Obsidian + LaTeX | 结构化公式教材 |
| 题目生成 | 知识点、题型模板 | WorkBuddy Skill | 题目+答案+解析 |
| 导出发布 | Markdown源文件 | Pandoc | PDF/Word/HTML |
这个架构的关键在于所有内容都以Markdown+LaTeX的形式存储。Markdown负责结构（标题、列表、表格、代码块），LaTeX负责公式，两者结合就能表达几乎所有的教材内容。存储格式统一之后，后续的转换、导出、复用都变得非常简单。
注意：不要一上来就追求全自动化。我的经验是先把手动流程跑通，确认每个环节的输入输出格式稳定之后，再用WorkBuddy把重复度最高的环节自动化。上来就搞全自动，出了问题排查起来非常痛苦。
2.3 环境准备与工具安装
Obsidian的安装很简单，官网下载对应系统的安装包，一路下一步就行。安装完成后新建一个库（Vault），建议放在一个专门的目录下，比如D:\TrainingVault。然后在设置里开启几个关键选项：编辑器里打开“显示行号”和“折叠标题”，核心插件里启用“模板”和“标签”，第三方插件里安装“MathJax”或“LaTeX Suite”用于公式渲染和快捷输入。
WorkBuddy的安装根据你用的版本有所不同。我用的桌面版，安装完成后需要配置模型接入和Skill目录。Skill目录是存放自定义技能的地方，每个Skill是一个文件夹，里面包含配置文件和处理逻辑。我建议把Skill目录也放在Obsidian库的旁边，方便文件互相引用。
MarkItDown的安装需要Python环境，命令行执行pip install markitdown即可。安装完成后可以用markitdown input.docx -o output.md这样的命令做转换。Pandoc的安装更简单，官网下载安装包，装完后命令行就能用。
3. 公式教材的Markdown+LaTeX编写实操
3.1 Markdown基础语法在教材编写中的运用
Markdown的语法本身不复杂，但用在教材编写上有几个关键点需要特别注意。标题层级用#到######表示，我建议教材最多用到四级标题，再深就该拆文件了。列表用-或1.，嵌套列表用缩进两个空格。表格用|分隔，这个在写公式对照表的时候特别有用。
代码块用三个反引号包裹，标注语言类型可以开启语法高亮。引用块用>开头，我习惯用它来标注“注意”“提示”“易错点”这类内容。加粗用**文字**，斜体用*文字*，行内代码用反引号包裹。
这里有个很多人会踩的坑：Markdown的换行。在标准Markdown里，单个换行符不会产生新段落，需要空一行才行。但有些渲染器支持在行尾加两个空格强制换行。我的建议是统一用空行分段，行内需要换行的地方用<br>标签，这样兼容性最好。
提示：Obsidian的实时预览模式下，公式渲染和Markdown渲染是同步的。如果你发现公式没渲染出来，先检查是不是MathJax插件没启用，或者公式的定界符写错了。
3.2 LaTeX公式输入的效率技巧
LaTeX公式的定界符有两种：行内公式用$...$，独立公式用$$...$$。在Obsidian里，行内公式会跟文字在同一行渲染，独立公式会居中单独占一行。
公式输入效率低是很多人的痛点。我的解决方案是安装LaTeX Suite插件，它可以自定义代码片段（Snippet），比如输入mk自动展开成$$...$$并把光标定位到中间，输入ff展开成分式\frac{}{}，输入sq展开成\sqrt{}。这些片段可以自己定义，用顺手之后输入速度能提升好几倍。
常用的公式符号我整理了一个速查表，放在Obsidian库的根目录下，需要的时候直接搜：
| 符号 | LaTeX代码 | 说明 |
|---|---|---|
| 分数 | \frac{a}{b} | a除以b |
| 平方根 | \sqrt{x} | x的平方根 |
| 求和 | \sum_{i=1}^{n} | 从1到n求和 |
| 积分 | \int_{a}^{b} | 从a到b积分 |
| 极限 | \lim_{x \to 0} | x趋于0的极限 |
| 矩阵 | \begin{matrix}...\end{matrix} | 矩阵环境 |
| 希腊字母 | \alpha \beta \gamma | 常用希腊字母 |
| 上下标 | x^2 y_1 | 上标和下标 |
对于复杂的多行公式，用\begin{align}...\end{align}环境，用&对齐等号，用\\换行。这个在推导过程比较长的公式里特别有用。
3.3 教材结构化组织的实操方法
Obsidian库的组织方式直接决定了后续出题和复用的效率。我的做法是按“课程-章节-知识点”三级目录来组织文件夹，每个知识点一个独立的.md文件。文件名用“编号+知识点名称”的格式，比如03-02-二次函数顶点公式.md。
每个知识点文件内部用统一的模板结构：
# 知识点名称 ## 定义 （用LaTeX写定义公式） ## 推导过程 （分步骤推导，每步用独立公式块） ## 例题 （典型例题+详细解答） ## 易错点 （常见错误和注意事项） ## 关联知识点 （用Obsidian的双链语法[[链接到其他知识点]]）这个模板的好处是结构统一，后续用WorkBuddy自动出题的时候，可以直接按“定义”“推导”“例题”这些章节来定位内容。双链语法[[...]]可以在知识点之间建立关联，Obsidian会自动生成关系图谱，方便你看到知识点之间的依赖关系。
注意：文件名不要用特殊字符，空格用短横线代替。Obsidian对文件名中的某些字符处理有问题，尤其是
#、[、]这些，会导致链接失效。
4. WorkBuddy自动出题的核心实现
4.1 Skill机制与出题模板设计
WorkBuddy的Skill机制是自动出题的核心。一个Skill本质上是一套预设的指令模板，告诉AI在什么场景下、按照什么规则、输出什么格式的内容。我设计了一个“公式题生成器”Skill，输入是知识点文件的内容，输出是若干道题目加答案加解析。
Skill的配置文件里需要定义几个关键参数：题型（选择题、填空题、计算题、证明题）、难度等级（基础、中等、进阶）、题目数量、输出格式。这些参数可以在调用的时候动态传入，比如“根据二次函数顶点公式这个知识点，生成5道中等难度的计算题”。
出题模板的设计有几个要点。第一，题目必须基于知识点内容生成，不能凭空编造。第二，答案和解析要分开输出，方便后续排版。第三，公式必须用LaTeX格式，保证渲染一致。第四，每道题要标注对应的知识点编号，方便后续组卷和检索。
4.2 批量出题的完整操作流程
实际操作的时候，我一般是这样跑的：
第一步，在Obsidian里打开要出题的知识点文件，确认内容完整、公式正确。第二步，在WorkBuddy里调用“公式题生成器”Skill，把知识点文件的内容作为输入传进去。第三步，设置参数：题型选“计算题”，难度选“中等”，数量填“10”。第四步，点击执行，等待AI生成题目。第五步，把生成的题目复制到Obsidian里新建的题目文件中，人工审核一遍，修正明显有问题的题目。
这个过程听起来简单，但有几个细节决定了效率。知识点文件的描述越详细，生成的题目质量越高。如果知识点文件里只有一行公式，AI生成的题目就会很空洞。如果知识点文件里有定义、推导、例题、易错点，AI就能从多个角度出题，题目质量明显更好。
另一个细节是分批生成。一次生成10道题比一次生成50道题的质量更稳定。我的做法是每次生成10道，审核通过后再生成下一批。这样即使某批质量不理想，也不会浪费太多时间。
4.3 题目质量的人工审核要点
AI生成的题目不能直接用，必须人工审核。我总结了一套审核清单：
- 公式是否正确：LaTeX语法有没有错误，渲染出来是不是预期的样子
- 数值是否合理：计算结果是不是整数或简单分数，有没有出现特别离谱的数字
- 题目是否可解：条件是否充分，有没有缺少必要信息
- 答案是否正确：自己算一遍，确认答案无误
- 解析是否清晰：步骤是否完整，有没有跳步
- 难度是否匹配：跟设定的难度等级是否一致
审核的时候我会在Obsidian里直接修改，改完的题目会打上一个“已审核”的标签。后续组卷的时候只从“已审核”的题目里选，保证质量。
实操心得：AI出题最常犯的错误是“条件不足”和“答案错误”。条件不足的题目直接删掉，答案错误的题目修正答案后保留。我一般会保留一个“待修正”文件夹，把有问题的题目先扔进去，有空的时候再处理。
5. MarkItDown与格式转换的实战细节
5.1 旧教材批量转换的操作步骤
手头积累的旧教材大多是Word格式，里面公式是用Word自带的公式编辑器写的。直接用MarkItDown转换的话，公式部分会丢失或变成乱码。我的处理方式是先用Word的“另存为”功能把文档存成PDF，再用MarkItDown转PDF，这样公式会以图片形式保留下来。
具体命令是markitdown input.pdf -o output.md。转换完成后打开Markdown文件检查，公式图片会以的形式嵌入。如果图片路径不对，需要手动调整。对于公式特别多的文档，我建议分章节转换，每次转一章，转完检查一遍再转下一章。
Word公式转LaTeX是另一个痛点。Word的公式编辑器不支持直接导出LaTeX，我的做法是用一个在线转换工具（比如某些开源的Word转LaTeX工具）先把公式转成LaTeX代码，再手动粘贴到Markdown文件里。这个过程比较费时，但比重新敲一遍公式还是快很多。
5.2 网页资料采集与Markdown化
做培训教材经常需要从网上搜集参考资料。WorkBuddy有一个“网页转Markdown”的Skill，输入网址，输出就是干净的Markdown内容，公式和表格都能保留。这个功能比手动复制粘贴强太多了，尤其是处理有大量公式的技术文档时。
采集回来的内容我会先存到一个“素材”文件夹里，打上来源标签和采集日期。后续编写教材的时候，直接从素材文件夹里引用内容，用Obsidian的双链语法链接过去。这样既保留了原始素材，又不会让教材文件变得臃肿。
注意：网页采集的内容要注意版权问题。我一般只采集公开的、允许引用的资料，并且在教材里标注来源。商业培训教材里尽量用自己的语言重新表述，避免直接大段引用。
5.3 导出为PDF和Word的配置方法
Markdown源文件写完之后，导出成PDF或Word用Pandoc。导出PDF需要先安装LaTeX发行版（比如TeX Live或MiKTeX），因为Pandoc生成PDF是通过LaTeX引擎来排版的。
导出PDF的命令是pandoc input.md -o output.pdf --pdf-engine=xelatex -V mainfont="SimSun"。这里--pdf-engine=xelatex指定用XeLaTeX引擎，-V mainfont指定中文字体。如果不指定中文字体，中文会显示成方块。
导出Word的命令是pandoc input.md -o output.docx。Pandoc会自动把Markdown的标题、列表、表格、公式转成Word对应的格式。公式会转成Word的OMML格式，可以在Word里继续编辑。
导出的时候有个细节要注意：图片路径。如果Markdown文件里引用了本地图片，导出的时候要确保图片路径是相对路径，并且图片文件在正确的位置。我一般把图片统一放在库根目录的attachments文件夹里，Markdown里用![]](attachments/图片名.png)引用。
6. 常见问题排查与避坑经验
6.1 公式渲染失败的排查思路
公式渲染不出来是最常见的问题。排查顺序是这样的：先检查定界符，行内公式必须是$...$，独立公式必须是$$...$$，前后不能有空格。再检查LaTeX语法，括号是否配对，命令拼写是否正确。然后检查Obsidian的MathJax插件是否启用，有时候插件更新后会自动关闭。最后检查是否有特殊字符冲突，比如公式里用了$符号本身，需要转义成\$。
如果公式在Obsidian里能渲染但导出PDF后不显示，大概率是LaTeX引擎的问题。检查是否安装了完整的LaTeX发行版，检查Pandoc的--pdf-engine参数是否正确。XeLaTeX对中文和公式的支持最好，建议优先用这个引擎。
6.2 Obsidian同步与备份方案
Obsidian的库本质上是本地文件夹，同步和备份有很多种方案。我用的是Git加云盘的双重方案。Git负责版本管理，每次修改后commit一次，可以随时回滚到之前的版本。云盘负责实时同步，在多台设备之间保持文件一致。
Git的方案需要一点命令行基础，但值得学。基本操作就三条命令：git add .添加所有修改，git commit -m "说明"提交修改，git push推送到远程仓库。远程仓库可以用GitHub的私有仓库，免费且稳定。
实操心得：Obsidian的
.obsidian文件夹里存的是插件配置和界面设置，这个文件夹建议也纳入Git管理，这样换设备的时候配置能直接同步过去。但要注意.obsidian/workspace文件记录的是当前打开的窗口状态，这个文件可以加到.gitignore里忽略掉。
6.3 常见问题速查表
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 公式不渲染 | 定界符错误 | 检查$和$$是否配对 |
| 公式渲染成乱码 | LaTeX语法错误 | 检查括号和命令拼写 |
| 导出PDF中文乱码 | 未指定中文字体 | 加-V mainfont="SimSun"参数 |
| 导出PDF公式丢失 | LaTeX引擎问题 | 换用XeLaTeX引擎 |
| 图片不显示 | 路径错误 | 检查图片路径和文件名 |
| WorkBuddy出题质量差 | 知识点描述太简略 | 补充定义、推导、例题等内容 |
| 转换后格式混乱 | 源文档结构复杂 | 分章节转换，逐段检查 |
| 同步冲突 | 多设备同时编辑 | 编辑前先pull，编辑后及时push |
6.4 效率提升的独家技巧
最后分享几个我实际用下来效果最明显的技巧。第一，建立常用公式片段库。把高频使用的公式（比如求导公式、积分公式、三角函数公式）整理成一个Markdown文件，写教材的时候直接复制粘贴，不用每次重新敲。第二，用WorkBuddy做公式格式批量转换。比如把Word格式的公式统一转成LaTeX，写一个Skill批量处理，比手动一个个改快得多。第三，题目文件按知识点编号命名，组卷的时候用脚本按编号筛选，几秒钟就能组出一套卷子。第四，定期整理Obsidian库，删除重复文件，合并相似知识点，保持库的整洁。库越乱，后续检索和复用的效率越低。
这套工作流我跑了大半年，最大的感受是：工具的价值不在于功能多强大，而在于能不能串成一条顺畅的流水线。WorkBuddy负责自动化和批量处理，Obsidian负责结构化和知识管理，MarkItDown负责格式转换，LaTeX负责公式表达，Markdown负责统一存储。每个工具各司其职，组合起来就是一套完整的教材生产线。刚开始搭建的时候会花一些时间，但一旦跑通，后面每一份教材、每一套题目的生产效率都是指数级的提升。
