企业官网建设流程全解析

做了六年企业内训，我最大的感受是：培训讲师不缺讲台上的能力，缺的是讲台下的时间。这两天把上一期训练营的交付材料整理完，终于把 WorkBuddy 和 Obsidian 这套组合彻底定型了：WorkBuddy 负责管公式教材、工作台和自动出题的流水线，Obsidian 负责管知识切片、标签和双向检索，两者配合下来，我自己的备课和组卷时间大概压缩了六成。如果你也是培训讲师、课程开发，或者正在被“备课两小时、讲课一小时”折磨的兼职讲师，这篇实操记录应该能直接抄作业。

这套组合解决的核心问题，说白了就是降本增效：把散落在各个文件夹里的教材、课件、公式、旧题，变成一套“可检索、可复用、可随机组卷”的资产。下面我按搭建顺序把思路、步骤和踩过的坑一次讲清楚。

1. 为什么培训讲师需要一套“教材+题库”的组合拳

1.1 讲台下的时间才是成本大头

很多新人讲师以为培训工作的重心是讲课，实际干过几年就知道，真正吃时间的是备课、找题、排版、对答案这些幕后动作。比如我上一期讲概率统计基础，光是把几十页旧教材里涉及到的公式重新核对一遍，就花了一个下午；再想从历次随堂测里挑出合适难度的题目，又得挨个翻 Word 文档，翻完还要担心题目重复。

这种低效的本质，是没有把“教材”和“题库”当成结构化资产在管理。教材是一堆逐年累加的 PDF、PPT、扫描件，题库是一堆名字像“期末卷_最终版_v3”的零散文件。讲师每次开新课，等于重新在垃圾堆里考古一次。用生活类比来说，这就像厨师每次备菜都要先把冰箱翻一遍，而不是事先把食材分门别类码好，炒菜时伸手就能拿。

WorkBuddy + Obsidian 的组合，恰恰是把“冰箱分区”这件事落到工具上。前者的项目工作台负责收纳和管理教材这类大块头素材，后者负责把公式、知识点、题目拆成可以灵活组合的卡片。原本需要反复人工检索和手工拼接的工作，变成了按标签筛选、按规则组卷的自动化流程。

1.2 WorkBuddy 和 Obsidian 各自扮演什么角色

先把两个工具的分工说清楚，避免一上来就混用。

WorkBuddy 在我的流程里定位是“教学工作台”，核心是项目管理。它能把一套课程的课件、讲义、公式典、题库、输出物放在一个项目空间里统一管理，并提供工作台视图快速进入常用素材。它擅长处理结构化程度较高的资源调度：哪些教材归入哪门课、哪些题目属于哪个章节、按什么权重组卷、最终导出成 PDF 还是 Word。简单说，它管的是“文件级”和“规则级”的事情。

Obsidian 则负责“知识级”的精细加工：某个公式适用什么条件、某道题考核理解还是记忆、题目和知识点之间有什么关联，这些信息都有字段和标签可以表达。它用 Markdown 纯文本存储，公式用 MathJax 渲染，天然适合把公式和题目拆成细粒度卡片，再用双链组成知识网络。

两者的关系不是替代，而是上下游。WorkBuddy 管教材项目，Obsidian 管知识切片和题库卡片，出题时由 WorkBuddy 读取 Obsidian 里筛选好的题目卡片，套用卷子模板生成成品。谁做哪块活，边界很清楚。

2. 方案架构：WorkBuddy 管教材，Obsidian 管知识点

2.1 整体思路：教材是“源材料”，题库是“加工品”

我建议在动手搭建之前，先接受一个理念：教材是源材料，题库是加工品，两者不能混在一个层级里。源材料的特点是相对稳定、体量大、不需要频繁修改；加工品的特点是原子化、带标签、要频繁组合复用。

对应到目录结构上，WorkBuddy 的项目里应该这样划分：

• 01 教材：原始 PDF、扫描件、外部课件
• 02 讲义：已经整理过的授课讲义
• 03 公式典：从教材里提炼出的公式清单
• 04 题库：从讲义/教材二次加工出的题目卡片
• 05 输出物：生成的试卷、讲义成品、给学员的 PDF

Obsidian 的库则专门承接 03 和 04 这两类加工品。我自己的习惯是 Obsidian 只放“经过自己理解后再整理的东西”，比如某一章的公式卡片、按题型分类的题目卡片、章节索引笔记。原始教材本身不进 Obsidian，因为体量大且格式复杂，硬塞进去会让知识库变得臃肿，检索效率反而下降。

这套分层的好处是，每次改版课程时，我只需要更新 WorkBuddy 项目里的“01 教材”和“02 讲义”，Obsidian 里的公式卡和题库卡都是可复用的稳定资产。换一门新课程，也不需要从零开始做题库，直接把相似的知识切片组合起来，再补新内容就行。

2.2 为什么不是 Word + Excel，也不是 Typora 单干

不少讲师习惯用 Word 写讲义、Excel 登记题目。这个组合在只有一两个班、课件量不大时没问题，但课程多了以后，问题非常明显。Word 文件之间的公式格式很难统一，图片和公式混排复制后经常错位或变形；Excel 存题目看起来整齐，但题干里的公式一旦带上下标和特殊符号，处理难度直接翻倍，更不用说随机抽题时还要来回写逻辑判断。

也有同行推荐过只用 Typora 写 Markdown，我也用过一阵子。Typora 确实是优秀的写作编辑器，公式预览体验很好，但它的定位是“写”，不是“管”。题目做多了以后，我需要的不只是把一篇讲义写出来，还要在不同章节之间跳转、给几千道题打标签、按难度和题型筛选，这些是知识库工具的本职工作，而不是编辑器的长项。

对比下来，WorkBuddy 解决“项目资源怎么组织、怎样按规则生成成品”，Obsidian 解决“知识卡片怎么维护、怎么建立关联”。一个管调度，一个管精细加工，这才是效率最大化的工作流。我把和 Word+Excel、Typora 的对比整理成了表格，方便决策时参考。

2.3 公式教材的处理：从扫描件到可检索素材

公式教材和普通讲义不一样，最大的坑是公式本身难录入、难检索。我的处理原则是：不追求一次全量数字化，而是按“够用”标准分层处理。

第一步，判断教材形式。如果是可复制的 PDF，直接导出文本层；如果是扫描版教材，先用 OCR 工具识别文字和公式，把公式尽量转成 LaTeX 代码。这里不推荐追求 100% 识别准确率，耗时不说，最容易出错的反而是一堆复杂积分符号和矩阵，人工校对成本极高。我自己的做法是，先保证章节标题、推导过程和结论性的核心公式能用，其余边角料先保留原图。

第二步，给公式做编号和语义标注。一个公式在 Obsidian 里至少要包含：公式内容（LaTeX）、所属章节、适用条件、常见变形。比如贝叶斯定理的公式卡片，我会在字段里写清楚这是“分类问题中的后验概率计算”，并关联到“全概率公式”和“先验概率”这两个卡片。没有语义标注的公式库，本质上就是一张没法检索的图片墙，后面自动出题时也选不到合适的题。

第三步，注意格式统一。所有进入 Obsidian 的公式，尽量统一用 LaTeX 包裹，不要有的用图片、有的用 Unicode 符号、有的用 Word 公式对象。不然到生成试卷时会遇到一个很尴尬的局面：预览时公式好好的，导出到 Word 后变成一堆乱码或者图片错位，这个问题在后面的常见问题里我会专门展开。

3. WorkBuddy 实操：从安装到建好第一个教材项目

3.1 安装、英文界面切换与目录规划

网上能找到不少《WorkBuddy 从入门到精通》之类的 PDF 教程，但很多默认读者是程序员，看得人一头雾水。对培训讲师来说，最实用的入门动作其实只有几步：下载安装、切换界面语言、建项目、规划目录。

不少用户下载后打开是英文界面，先别急着找卸载按钮。大多数版本的 WorkBuddy 在设置里都提供语言切换，找到 Language 或 Interface 相关选项，切到简体中文后重启即可。个别版本可能只提供英文界面，这时候也不用恐慌，它的核心菜单就 Project、Workbench、Settings、Export 这几个，看熟了很快就能上手。真要说起来，英文菜单反而更容易在网上搜到对应的设置位置。

安装完成后的第一件事，是建项目而不是直接导文件。新建项目时我建议把项目根目录指向一个空间充足的盘符，并提前按这套骨架建文件夹：01 教材、02 讲义、03 公式典、04 题库、05 输出物。这个结构看起来简单，但后面自动出题时需要读取“04 题库”，导出卷子时写入“05 输出物”，如果一开始就乱放，后面流程跑不起来。

注意：项目根目录建议避免使用过长的中文路径或者带空格的路径，部分版本的资源索引对特殊字符支持不稳定，路径越简单越省心。

3.2 用“工作台”把课件、讲义、公式典统一管理

WorkBuddy 的工作台，我理解成一个“项目控制台”。它和传统网盘的最大区别是：网盘只负责存文件，工作台负责把常用的文件夹、任务模板、出题规则做成快捷入口，让讲师打开软件后立刻知道下一步该干嘛。

我的工作台是这样配置的：第一屏放“01 教材”“02 讲义”“03 公式典”三个资源入口，第二屏放“模板中心”和“出题任务”，第三屏放“最近更新”和“项目日志”。这样每次开新课，我不用在资源管理器里一层一层翻文件夹，直接在工作台点进对应入口即可。

配置工作台时有一个细节容易被忽略：工作台的入口最好指向“文件夹”而不是“单个文件”。因为教材和讲义迭代后文件名会变，指向文件夹能保证入口长期有效。我有段时间偷懒，把工作台快捷方式直接指向了某个 PPT 文件，结果下一版讲义改了名字，工作台入口直接失效，重新配还花了几分钟，这个亏吃过一次就不会再犯了。

3.3 修改缓存目录与项目搬迁

关于 WorkBuddy 缓存目录怎么更改，我是在给笔记本换大容量硬盘时踩到这个点的。默认情况下，WorkBuddy 会把教材预览、OCR 临时文件和题目素材的索引放在系统盘，时间一长 C 盘空间告急。修改方法不复杂：进入设置，找到缓存或存储相关选项，把缓存目录改成其他盘符下的专用文件夹，然后重启软件。

这里有个关键步骤容易漏：修改缓存路径后，需要把原缓存目录里的旧文件迁移到新目录，否则项目打开时会重新下载或重建索引，耗费大量时间。迁移时最好先关闭 WorkBuddy，直接复制整个缓存文件夹，再重新指向新路径。有些版本会提示缓存目录修改失败，常见原因是目标盘符不存在、文件夹没有写入权限，或者软件没有完全退出就做了修改，按顺序排查很快能解决。

项目搬迁是另一个高频需求。WorkBuddy 的项目文件通常包含资源索引和相对路径，搬迁时最稳妥的做法是把整个项目文件夹完整移动，不要只拷走一个子目录。搬到新电脑后如果资源路径失效，去项目设置里重新指定项目根目录即可。我在搬迁后经常遇到教材预览空白的情况，一般就是资源索引还没重建，让软件重新扫描一遍项目目录就能恢复。

3.4 导入 PDF 教程和旧课件时的格式处理

导入旧课件时，最容易踩的坑是“文件能打开，但内容没法用”。具体来说：Word 旧课件有大量文本框和公式对象，导入 WorkBuddy 后索引到的往往是文档整体，没法定位到某一页的某个知识点；PDF 讲义如果原版就是扫描件，WorkBuddy 只能把它当一个整体素材，没法做细粒度的出题引用。

我的处理建议是分两种情况。第一种，旧版 Word 课件优先转成 PDF 再导入，同时保留原始 Word 作为备份，但 WorkBuddy 项目里实际引用 PDF，因为 PDF 的页面定位和导出兼容性更好。第二种，扫描版 PDF 需要先做 OCR，生成带文字层的 PDF 文件后导入，这样后续在 Obsidian 里做知识切片时，至少能引用到对应段落。

实测下来，导入后给每个文档打上版本标记非常有用。我的命名习惯是“日期_课程名_章节_版本”，比如20250315_概率统计_第3章_v2.pdf。别小看这个细节，不按规范命名的话，一学期后很可能出现八个版本的同一份讲义，连自己都分不清哪份是最新的。自动出题最怕的就是素材版本错乱，题目引用的公式来源如果是旧版讲义，那整张卷子的权威性都会受影响。

4. Obsidian 侧的知识库搭建：让公式和题目能双向检索

4.1 为什么选 Obsidian 而不是继续用 Typora

很多讲师在用 Typora 写 Markdown，体验很好，我在 2.2 里也说过它只擅长“写”而不是“管”。这里单独展开 Obsidian 相对 Typora 的几个关键优势，帮助你在迁移前看明白自己要什么。

首先，Obsidian 是真正的知识库，文件可以互相链接。Typora 里你只能通过目录结构来组织内容，而 Obsidian 支持双链，题目卡片可以同时挂在“章节索引”和“题型索引”下，不需要复制文件，甚至不需要移动文件。其次，Obsidian 的属性（YAML frontmatter）可以直接给题目写难度、题型、知识点标签， Typora 虽然有 frontmatter，但没有那么强的筛选和查询生态。最后，Obsidian 的标签体系和搜索语法足够灵活，我可以很快查“所有难度为高的概率计算题”，这在 Typora 里几乎做不到。

用生活类比来说，Typora 像一张干净的稿纸，写起来舒服，但写完就放进档案柜不管了；Obsidian 像一个带索引的活页夹，每页都能贴上标签，还能用关联线把相关内容串起来。对需要长期积累题库的人来说，后者才是可持续的选择。

4.2 三类笔记：章节索引、公式卡片、题库卡片

Obsidian 库不要一上来就堆文件。我在库中只维护三类明确分工的笔记，这个约定建议从一开始就定下来。

第一类是章节索引笔记，相当于地图。比如“概率论第3章”，里面列出本章核心公式的链接、已有题目的链接、以及本章对应的教材 PDF 路径。索引笔记本身不写详细内容，只做中枢导航。

第二类是公式卡片，一张卡只讲一个公式。YAML 属性至少包含：tags（知识点标签）、chapter（所属章节）、condition（适用条件）、linked_notes（相关公式）。正文部分固定为“公式、推导要点、典型例题、易错点”四段，控制在一屏左右。不要让公式卡片膨胀成论文，不然检索和引用都会变笨重。

第三类是题库卡片，一道题一张卡。YAML 属性包含：tags（题型、知识点、难度）、type（单选/填空/计算）、difficulty（1-5）、chapter、answer、analysis。题干中的变量建议用占位符标记，比如{a}、{b}，方便 WorkBuddy 出题时自动替换参数。

下面是题库卡片的示例，结构可以直接套用：

--- tags: [计算题, 条件概率, 难度3] type: 计算 chapter: 第3章 difficulty: 3 knowledge: 贝叶斯公式 --- 已知事件 A 的发生概率为 {p}，在 A 发生的条件下事件 B 发生的概率为 {q}，求 P(A|B)。 答案：见解析

实际使用中，我会把{p}、{q}的取值生成规则写在 WorkBuddy 题模板里，而不是写在卡片里，这样一张卡可以变换出几十道数值不同的题，实现真正的“一题多用”。

4.3 加标签与双链：给公式和题目打上可检索的“坐标”

Obsidian 的标签看着简单，用不好就会变成一锅粥。我建议标签分为三组，各司其职，不要混用。

第一组是场景标签，表达题目/公式出现在什么环节，比如#精讲、#随堂测、#期末。第二组是题型标签，比如#单选、#填空、#计算。第三组是知识点标签，比如#条件概率、#随机变量、#大数定律。三组标签共同组成一道题的“坐标”：场景决定哪里会被用，题型决定卷面上长什么样，知识点决定题目考的是什么。

出题时，WorkBuddy 项目的出题规则会读取这些标签。比如配置“从#计算题且#条件概率且难度为 3 的题目中抽 5 道”，本质上就是一次按标签组合的筛选。标签命名最好在项目一开始就定成文档，团队讲师共用一份，避免出现同义标签，比如有人用#条件概率有人用#贝叶斯，筛选时漏题就很难查。

双链的作用比标签更近一步。我在公式卡片里会链接到它被哪些题目卡片引用；在题目卡片里会链接到它考核的公式卡片。这样从一道题可以跳到对应知识点，从知识点又能看到相关题目，查漏补缺非常直观。举个例子，某次统计学员错误率时发现“全概率公式”相关题目的错误率明显偏高，我直接从公式卡片点开所有关联题目，把易错点集中过一次，比翻教材高效得多。

4.4 主题 anuppuccin 装不上怎么办

Obsidian 的主题 anuppuccin 在讲师圈子很流行，因为界面配色舒适，公式排版也干净。但很多人遇到安装失败，提示无法安装。

第一次遇到这个提示，先不用怀疑自己的操作。常见原因有两个：一是当前 Obsidian 版本和主题版本不兼容，二是主题市场直接拉取主题包失败。解决办法是手动安装：去主题仓库把最新版或稳定版的主题包下载下来，解压后放进 Obsidian 库目录下的.obsidian/themes/AnuPpuccin/，然后重启 Obsidian，在设置→外观→主题里选中即可。

这里没有最优解，反而最怕的是硬追最新版。主题工具的稳定性比花哨重要得多，我已经吃过好几次“新主题导致预览卡顿”的亏。如果你做自动出题量大，核心诉求应该是预览流畅、公式渲染清晰、桌面端和移动端一致，这些用内置默认主题也能满足。主题折腾这事，点到为止就好。

4.5 飞书连接 Obsidian 的轻量协作方案

很多培训团队现在用飞书协作，讲师整理好题库后希望同步给同事，或者让助教在飞书文档里维护课程资料。飞书连接 Obsidian 的方案我试过几种，最轻量的不是实时双向同步，而是按需导出。

具体做法是：在 Obsidian 里把需要共享的笔记整理进一个“共享区”文件夹，通过 Obsidian 的导出功能生成 Markdown，再粘贴到飞书云文档；或者让 WorkBuddy 把已经生成的卷子和讲义直接导出 PDF，上传到飞书知识库的对应目录。对培训团队来说，学员最终看到的一定是排版好的 PDF 或在线文档，而不是 Obsidian 里的 Markdown 卡片，所以没必要追求两端实时一致。

如果团队想用飞书多维表格来做题库管理，WorkBuddy 会是一个不错的节点：它把 Obsidian 题库卡片筛选出来后，可以按固定字段输出成表格数据，再由讲师或助教导入飞书多维表格。这里要提醒一句：Markdown 里的复杂公式一旦进入富文本表格，很容易渲染丢格式，所以导入多维表格时，公式最好以图片或 LaTeX 源码形式单独存一列，不要指望飞书能直接解析所有公式语法。

5. 自动出题：把题库变成随机组卷流水线

5.1 出题逻辑：知识切片、题型模板、随机参数

自动出题的重点不在“随机”，而在“约束”。完全随机的卷子和手动组卷一样糟糕，可能知识点扎堆、难度失衡、题型单调。我用的出题逻辑封装成一句话就是：知识点覆盖 + 题型比例 + 难度分布 + 不重复约束。

知识点覆盖是指一张卷子要考到哪几个标签，不能选完题才发现全部落在“条件概率”上，后面的“大数定律”一道题都没有。题型比例是指单选、填空、计算各占多少，这直接影响卷面结构。难度分布则控制易、中、难的比例，我会根据培训对象的历史正确率动态调整。不重复约束包括题目不要在同一张卷子里重复出现，尽量也别和上次考试用过的题目重合，这时候题库卡片的 YAML 字段就派上了用场。

参数化随机是另一层进阶玩法。题库卡片里的{p}、{q}这类占位符，由 WorkBuddy 在出题时从指定范围里生成数值。比如条件概率题，我可以配置 p 在 0.2~0.5 之间取两位小数，q 在 0.3~0.7 之间取两位小数，这样同一道题每一遍生成的数值都不同，批量训练时不怕学员互相抄答案。

5.2 WorkBuddy 与 Obsidian 的联动方式

很多人第一反应是问：WorkBuddy 能不能直接读取 Obsidian？在我的实践里，最简单可靠的联动方式是“目录共享 + YAML 解析”，而不是强行要求两个软件原生互通。

操作上，把 Obsidian 知识库的“04 题库”文件夹直接建在 WorkBuddy 项目根目录下，也就是让 Obsidian 的题库目录与 WorkBuddy 的“04 题库”指向同一物理文件夹。这样 WorkBuddy 索引项目时，就能扫描到 Obsidian 写的题库卡片，Obsidian 编辑保存后，WorkBuddy 稍后读取时拿到的就是最新内容。

WorkBuddy 读取题库卡片的关键动作是解析 YAML frontmatter。每一道题的 tags、type、difficulty、chapter 字段都结构化以后，WorkBuddy 的出题规则就可以做筛选组合。这样实现的本质是：文件用 Markdown 存，筛选用标签跑，两个工具在一个文件夹下协作，不依赖复杂的实时通信接口，稳定性和可维护性都很好。家庭作坊也好、小团队也好，这套模式都够用了。

5.3 一套可复现的组卷流程（含权重与参数示例）

下面给出一套我自己一直用的组卷参数，可以直接照搬调整。

假设我的培训专题共 5 章，目标卷子 30 题，时长 60 分钟：

实施步骤：

1. 在 Obsidian 里确认所有题目卡片都已经按规范填好 YAML，特别是标签和难度字段不能有遗漏。
2. 在 WorkBuddy 出题模板中新建“30题限时卷”，按上面表格设置题型比例和知识点覆盖条件。
3. 配置随机参数范围，例如填空题中的数值范围、计算题中的条件概率 p 和 q 的取值区间。
4. 运行出题，WorkBuddy 从“04 题库”里按约束筛选并随机抽取，生成一张草稿卷。
5. 让 WorkBuddy 导出为 PDF，然后人工复核，确认无误后进入“05 输出物”并归档。

这套流程里有一个关键设置希望大家注意：每次出题要保留一个“种子号”。多数模板支持固定随机种子，只要种子号不变，重新生成同一次卷子时题目和参数能完全复现。这对后续改版、做讲评、复现学员错题场景非常有用。没有种子号的随机出题，等于一个想起来完全一样的卷子生成不出来，后续解析课非常被动。

5.4 自动出题后的复核清单

自动出题不是一键发卷，它只是把“手工组卷”从两小时变成两分钟，但两分钟生成的初稿仍然需要人工把关。我给自己定的复核清单如下：

• 知识点分布是否符合预期，有没有某个标签占了半张卷子。
• 难度标注是否准确，特别是新入库的题目难度是基于估计还是实际正确率。
• 参数替换后的数值是否合理，比如分母不为零、取值不出现负概率。
• 题目是否重复，既看卷内重复，也看与上一次考试的重合度。
• 公式渲染是否正常，尤其是导出 PDF 后有没有乱码和变形。

实操中我一般会在出题后保留 15 分钟做人工过目，而不是直接发给学员。说实话，这套复核环节才是保证降本增效不翻车的关键，跳过了它，后面学员反馈、评分、答疑的时间成本会成倍反弹。

6. 常见问题与排查技巧实录

6.1 WorkBuddy 下载后是英文版，先别急着卸载

这个问题的处理我在 3.1 已经提过，但还是值得单独强调。英文界面不等于只能用英文，先到设置里找语言切换，一般位于 General 或 Preferences 下。切换后需要重启软件才能完全生效。

如果设置里没有中文选项，注意检查下载的版本是否是面向海外用户的国际版。你可以重新下载中文版安装包，但记得先备份 WorkBuddy 项目文件夹，避免覆盖已有项目数据。只要你没有把项目文件存在安装目录里，换版本安装一般不影响既有教材和题库。如果安装后界面正常了但项目资源不显示，重新指定项目根目录即可。

6.2 缓存目录改不了或报错怎么排查

缓存目录修改失败，我按以下顺序排查：

1. 目标目录是否存在。如果路径里有一个字母拼错，软件不会自动帮你建目录，先手动建好。
2. 是否有写入权限。在 Windows 上，有些盘符根目录或者受保护的系统目录没有普通写入权限，建议单独建一个名为WorkBuddyCache的普通文件夹。
3. 软件是否完全退出。有时候任务栏关闭了，但后台进程还在运行，需要从任务管理器确认 WorkBuddy 进程全部退出后再修改设置。
4. 旧缓存是否被占用。如果同时开着 Obsidian 或其他软件访问缓存目录里的文件，迁移时也会报错，关掉相关应用再试。

还有一个小经验：缓存目录不要用中文名。我见过几次中文路径导致资源索引重建失败的情况，虽然不一定在所有版本都复现，但为了省心，全英文路径是最稳的选择。

6.3 Obsidian 附件丢失和同步冲突

Obsidian 里的公式卡片可能带有截图、图片等附件，附件管理不当会经常出现“图片加载失败”的红色警告。我的建议是第一次建库时就去设置里把附件默认路径统一设置为_attachments文件夹，不要把附件散落在各个笔记目录里。

同步冲突则常常发生在笔记本、桌面端、手机端同时使用时。只要 Obsidian 开着，同步工具又同时在后台上传下载，很容易出现冲突文件。排查技巧是：同步操作前先关闭 Obsidian，或者至少等 Obsidian 完全索引完成再同步。冲突文件出现后不要直接删，先打开带“conflicted”标记的版本看看，把两边更新的内容合并一次。我一开始图省事直接删冲突文件，结果丢过几条关键笔记，后来再也不敢了。

6.4 公式渲染不统一：图片与文本混排

公式问题是培训讲师最看重也最容易炸的一个点。Obsidian 里公式用 MathJax 渲染，预览效果很不错；但一旦导出成 Word 或飞书文档，MathJax 语法未必被目标环境支持，公式可能变成图片、乱码或者干脆消失。

我的对策很直接：最终交付给学员的材料一律用 PDF 导出。PDF 是唯一能保留公式排版、页码和版式的稳定格式。如果课程组必须用 Word 文档，那我会把试卷导出为 PDF 后再转成一个 Word，公式部分已经图片化，虽然不可编辑，但视觉上稳定不乱。

如果你要长期维护题库，建议公式以 LaTeX 源码为核心存储格式，同时保留一份 PDF 或图片快照作预览。不要混用“这一题公式用图片，那一题公式用文本”，否则后面做自动组卷时会出现同一张卷子公式风格五花八门的尴尬情况。

6.5 小程序教学应用案例的延伸

最后聊一个衍生场景。培训团队如果想做小程序端的每日一练，WorkBuddy + Obsidian 的题库资产可以直接复用。从 Obsidian 里筛选出指定标签的题目卡片，通过 WorkBuddy 导出成结构化数据，再转成小程序端能读取的 JSON 格式，就能实现“教材里出公式、题库里抽题目、小程序上练一遍”的闭环。

小程序端公式展示要注意，和 6.4 一样存在渲染环境差异。如果小程序端没有 MathJax 支持，最省事的方案是把公式渲染成图片后再在题目里引用，或者用支持 LaTeX 渲染的富文本组件。我的实际体会是，做小程序端不要一上来追求复杂交互，先做每日一练、错题回顾这几个核心功能，把公式显示稳定了再扩展。

7. 一点个人体会

这套组合跑顺之后，组一份 30 题的试卷，从选题到导出 PDF，我现在的耗时大概在 20 分钟上下，而以前至少需要半天。真正带来效率提升的，其实不是某一个工具多智能，而是 WorkBuddy 和 Obsidian 帮我把“每一次出题都变成了素材沉淀”：每写一道新题，就是给题库添一块砖；每整理一个公式，就是给后续备课清一次路障。

如果你也想照着搭，我的建议是不要一上来追求完美。第一周只做两件事：把教材导入 WorkBuddy 项目，把接下来要用的公式卡片在 Obsidian 里建起来。标签体系不够完善没关系，先用起来，遇到筛选困难时再补齐。这比花一整天研究主题美化、读一堆云里雾里的 PDF 入门教程实际得多。

最后再分享一个每天都在用的小技巧：在 Obsidian 里配一个“新建公式卡片”和“新建题目卡片”的模板，每次入库新内容时自动带出 YAML 字段，省得每次都手打 tags 和 knowledge。习惯这个动作以后，题库的维护成本会低到让你愿意长期坚持，自动出题这件事才真正有了源源不断的弹药。