Obsidian 笔记导出 Word 完整指南：双链、嵌入图、Callout 全部搞定

如果你是 Obsidian 重度用户，一定遇到过这样的尴尬。花了三个月攒起来的一篇调研笔记，里面全是 Obsidian 特有的语法，比如：

[[Project Plan]]        → 链接到另一篇笔记
![[diagram.png]]        → 嵌入的图片
> [!note] Key insight   → Callout 提示块

然后同事来找你要一份 Word 版本——打开一看，上面这些非标准语法全部翻车。

我第一次遇到这个问题，是把一份 40 页的技术调查交给一位完全不碰 Obsidian 的项目干系人。原本在 vault 里看着挺精致的文档，到了 Word 里满屏都是字面的方括号和孤零零的图片占位符。后来又反复踩过几次坑，我才慢慢摸出一套能真正跑通的流程。这篇文章就是把这套流程整理出来——包括大多数人都会跳过的预处理环节、三个真正值得你重视的 Obsidian 语法坑，以及图片或 Callout 死活不听话时该怎么办。

为什么 Obsidian 的 Markdown 不能直接用（以及到底是哪里出了问题）

Obsidian 把笔记存成普通的 .md 文件，所以很多人理所当然地以为导出 Word 就是一键的事。但实际上并不是——因为 Obsidian 在标准 Markdown 之外加了一堆扩展，通用转换器根本不认识。

下面这四个扩展几乎能解释所有的导出翻车现场：

标准的 Markdown 转换器——Pandoc 或大部分在线工具——会把 [[...]] 当成纯文本，![[...]] 当成不认识的 token。你在 Obsidian 里看到的漂亮效果只是一个 预览视图，并不是源文件本身。搞不清楚这一点，几乎是所有「为啥我导出来就乱了」抓狂的根源。

还有一个更隐蔽的问题：附件路径。Obsidian 解析 ![[image.png]] 的时候，会在整个 vault 里搜索匹配的文件名，不管它在哪个文件夹。但标准 Markdown 需要一个明确的相对路径。如果你的附件放在 99 Attachments/ 文件夹，而笔记在 10 Projects/ 下，那图片链接必须先重写，转换器才找得到。

导出前先做的一步：预处理能救命

我这套流程里可靠性提升最大的一环，就是在跑任何转换器之前，先做 5 分钟的预处理。跳过这一步，等你拿到 Word 文件之后得花 30 分钟清理。

第一步：检查附件相关设置

打开 Settings → Files and links，注意两个地方：

• Default location for new attachments —— 新图片、PDF 放到哪里
• New link format —— Obsidian 怎么写路径（Shortest path when possible、Relative path to file 还是 Absolute path in vault）

如果这个设置是 Shortest path when possible（这是 Obsidian 的默认值），那么只要笔记和附件不在同一个文件夹，导出就必翻车。导出前先把它切到 Relative path to file。注意这个设置只对以后的链接生效——已经存在的链接还是老格式，得走下面第二步去重写。

第二步：把 wikilinks 转成标准 Markdown 链接

Obsidian 有个现成的开关：Settings → Files and links → Use [[Wikilinks]] → OFF。关掉之后，新建的链接会变成 [Note Name](Note-Name.md) 这种标准格式。但它只对 新 链接生效。

要把笔记里已经存在的 [[wikilinks]] 转掉，两种办法：

1. 导出量小的手动搞 —— 在笔记里按 Cmd/Ctrl+F，搜 [[，挨个改。5 页以内的笔记完全够用。
2. vault 比较大就上插件 —— 打开 Settings → Community plugins，搜一下 "link converter" 或者 "markdown links"。社区里有好几个插件能批量把 wikilinks（以及 ![[...]] 形式的嵌入附件）转成标准 Markdown 语法，可以针对当前文件，也可以整个文件夹跑。挑一个最近有更新、下载量让你放心的就行。

转完之后，你的嵌入附件会变成 ![image.png](path/to/image.png) 这种样子。顺便检查一下——如果附件文件夹名字里有空格，记得把空格做 URL 编码（My%20Vault/attachment.png），否则转换器会默默把图片吞掉。

第三步：决定 Callout 怎么处理

Obsidian 的 Callout（> [!note]、> [!warning] 等等）在 vault 里很好用，但 Word 里完全没有对应的东西。有三种处理办法，按工作量从低到高排：

• 接受降级 —— 让它退化成普通引用块。Callout 的 类型（note/warning/tip）会丢，但内容还在。对大部分交付场景来说够用。
• 关键的手动改写 —— 导出前把 > [!warning] Critical 改成 > **⚠️ Critical：**。这样两边看起来都像那么回事。
• Word 里再修饰 —— 用 Word 的快速样式把引用块改成带底色的样式方框。只有对外正式交付的文档才值得这么折腾。

20 页以内的文档我用第二种方案，更长的就用第一种。

第四步：把 Dataview 块转成静态内容

如果你的笔记里有 Dataview 查询，导出后你拿到的是 查询代码 而不是结果表。导出前先在 Obsidian 里跑一下查询，把渲染出来的结果复制下来，以静态 Markdown 表格的形式替换掉原来的代码块。是的，这是纯手工活。不过确实也没什么干净的绕路方案——Dataview 是在客户端渲染的，源文件里压根就不包含那些数据。

四步走的标准导出流程

预处理做完之后，真正的转换步骤就很简单了。

1. 先复制一份笔记（别在原地动手）

把目标笔记和它的附件复制到 vault 以外的一个临时文件夹里。你肯定不希望预处理的改动（链接重写、Callout 替换）污染到主 vault。我习惯在桌面放一个 _export-staging/ 文件夹专门干这事。

2. 把附件路径拉平

把所有引用到的图片都移到和 .md 文件相同的文件夹里，把链接改成最简单的文件名：![diagram](diagram.png) 而不是 ![diagram](../../99 Attachments/diagram.png)。大部分转换器碰到一路往上跳的路径就犯迷糊。

3. 跑转换器

把处理好的 .md 文件上传到 MarkFlow 的 Markdown 转 Word 转换器。它支持 GitHub Flavored Markdown（GFM），包括表格、任务列表和脚注——也就是 Obsidian 预处理之后产出的所有标准特性都能覆盖到。图片会内嵌进去，代码块保留语法高亮，各级标题会映射到 Word 自带的标题样式，这样在生成的 DOCX 里导航窗格能正常用。

如果笔记里有 LaTeX 数学公式（$E=mc^2$ 或者 $$...$$），确认你选的转换器是把它转成 Word 的公式对象而不是压扁成纯文本。对于公式密集的笔记——比如科研记录、学术初稿——这个能力几乎是生死线。如果最终目标并不是 Word，只是想拿到一个能分享的文件，把 Markdown 转成 PDF 可以完全绕开 Word 那些公式渲染的怪癖。

4. 在 Word 里再加工

打开 DOCX，有模板的话套一个你们团队的 Word 模板。Markdown 的标题样式会干净地映射到 Word 自带的「标题 1/2/3」上，所以整篇文档换一套风格只需要在 Design → Document Formatting 里点一下。发出去之前检查这三件事：

• 目录 —— 通过 References → Table of Contents 插入一个目录，验证所有标题层级有没有识别正确
• 图片尺寸 —— Obsidian 按图片原始大小显示，Word 里可能会被撑得很大。需要的话全选批量调整
• 超链接 —— 外部链接应该是可以点的；[[wikilinks]] 要么已经解析掉，要么就直接删掉

Obsidian 专有的几个边缘场景

下面这几种情况出现频率够高，单独拎出来说一下。

日记和模板

如果你导出的是用了 {{date}} 或者 Templater 变量的日记，导出是在 Obsidian 已经替换完变量 之后 发生的——所以导出的 .md 里是真实日期，不是占位符。不需要特殊处理。唯一的例外是你绕过 Obsidian，直接从文件系统导出——那没解析的模板就会泄漏到最终文档里。先在 Obsidian 里打开笔记让它渲染一下，再做导出。

Canvas 画布文件

Obsidian 的 Canvas（.canvas）文件本质是 JSON，不是 Markdown，没有任何 Markdown 转换器会理它。对 Canvas 来说，比较现实的做法是：把画布缩放到你想要的比例截图，存成 PNG，再嵌到一篇专门用来导出的包装笔记里。社区里也有一些插件直接提供「把 canvas 导出为图片」的功能，如果你经常需要这么干，可以装一个省事。

Mermaid 流程图

用 mermaid 标记的围栏代码块在 Obsidian 里会被渲染成图。大部分在线的 Markdown 转 Word 工具要么把它渲染成图片（好），要么原封不动留着代码（坏）。MarkFlow 会先把 Mermaid 渲染成内嵌 SVG 再做转换，Word 里显示为可编辑的图片。如果你用的转换器不支持 Mermaid，退路就是从 Obsidian 视图里把图导出成 PNG，然后把代码块替换成标准的图片引用。

脚注

好消息——Obsidian 的脚注语法（[^1] 以及定义 [^1]: text）就是标准的 GFM，能干净地转成 Word 自带的脚注功能，完全不用预处理。

标签和 frontmatter

YAML frontmatter（笔记开头 --- 包起来的那一坨）通常会被转换器直接剥掉。如果 frontmatter 里有读者需要看到的信息（作者、日期、状态），导出前把它们挪到正文里以正常段落的形式写出来。像 #project/research 这种行内标签一般会以纯文本的形式保留——多数场景能接受，有些场景看着很违和。如果这份 Word 要交给不用 Obsidian 的人看，用查找替换把它们删掉就好。

什么时候手动搞反而比自动化更快

讲真：如果只是一篇 2-3 页、格式也不复杂的短文档，最快的办法是 在 Obsidian 阅读视图里复制，然后直接粘贴到 Word。Obsidian 的阅读模式是渲染成 HTML 的，Word 粘贴 HTML 的保真度意外地不错。表格能过来，粗体斜体还在，标题也能对应到 Word 的标题样式。

这种「从阅读视图复制」的方案在这三件事上会翻车：

1. 图片 —— 粘过去是指向 vault 里文件的链接引用，文件一离开你的电脑就全断了
2. 代码块 —— 语法高亮没了，等宽字体还常常不一致
3. Callout 和 Mermaid —— 和标准导出一样会挂

所以：没有代码和图片的短笔记 → 直接粘。更长的或者技术类的 → 老老实实走上面的四步流程。

故障排查：出问题了怎么办

下面这几种翻车是我见得最多的。想了解更全面的排查思路，可以看这篇 Markdown 转换常见问题排查，里面覆盖了 15 个高频转换问题。

Word 文件里图片不见了。 九成情况下是路径的锅。打开 .md 源文件看一眼——附件路径是简单的文件名（image.png），还是复杂的多层路径（../../99 Attachments/My Folder/image.png）？拉平它。

表格挤成一行。 说明源文件用的是 Obsidian 老版本的表格格式，或者管道符对不齐。用纯文本编辑器打开 .md，确认每行管道符数量一致。表头的分隔行也要对应：| --- | --- |。

代码块没有语言颜色。 检查围栏后面有没有跟上语言标识符（比如 python、js、`bash），三个反引号紧跟语言名。转换器靠这个标签决定语法高亮；不带标签的围栏会默认走纯文本。

导出之后 [[Note Name]] 还是原样显示。 预处理没跑，或者这个文件没被处理到。确认 Use [[Wikilinks]] 已经关掉，然后用你第二步装的那个插件针对这个文件再跑一遍——多数插件都支持只对单个笔记生效，不用整个 vault 重刷。

公式显示成原始 LaTeX 代码。 转换器不支持公式渲染。要么换一个转换器，要么在 Obsidian 里把渲染好的公式截图做成图片嵌进去——丑是丑了点，但保准能显示。

团队协作场景下的靠谱流程

如果你是团队里唯一用 Obsidian 的人，而其他人都要 Word 文件，建议搭一个可复用的流程，而不是每次都临时救火。我在协作项目里跑的版本是这样的：

1. vault 里专门开一个 Exports/ 文件夹，所有要发 Word 的笔记都放这里
2. 这个文件夹里从一开始就用标准 Markdown 链接（[text](note.md)），不用 wikilinks——直接省掉预处理
3. 每周一次，对有改动的笔记批量跑一次转换
4. DOCX 产物放到共享盘里，不要塞回 vault

思路就是把你的 思考空间（主 vault，用足 Obsidian 的各种特色）和 交付空间（说标准 Markdown 的 Exports/ 文件夹）分开。第一次做这个拆分花了我一个小时，但每个月都能省出好几个小时。

如果你是从反方向过来的——平时用 Markdown 写作，想把基础打扎实——可以看 如何用 Markdown 写作，里面讲的基本功能让任何导出都更顺滑。想更深入了解转换这一侧，Markdown 转 Word 完整指南 覆盖了对复杂文档真正有用的转换器特性。

写在最后

Obsidian 的真正价值就在那些非标准特性上——wikilinks、Callout、动态查询——正是它们让 vault 有了生命力。导出 Word 意味着你得放弃其中大部分。诀窍是别再跟它较劲：接受 Word 版本注定是一个被拍扁的呈现，相应地做好预处理，然后用 Word 自己的样式工具在关键处重新把质感堆回来。

一旦预处理变成肌肉记忆，整条流水线每篇笔记只要大约 5 分钟。这就是「回头再说吧」和「今天就把文档发出去」之间的差别。