SiYuan Word互操作怎么用：3步导入docx，笔记转Word一键搞定

SiYuan Word互操作怎么用：3步导入docx，笔记转Word一键搞定

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan

在 SiYuan（思源笔记）里，Word 互操作走两个方向：把.docx文件导入成可编辑的块级笔记，再把笔记导出回 Word。本文按"搬进"和"送出"两个场景把路径讲清，顺带说明背后涉及哪些配置，以及导出翻车时该查什么。

把 Word 报告搬进笔记：导入前先看这 3 件事

📌 场景：一份.docx报告躺在本地，你想让它的每个段落、每张小表都能被 SiYuan 单独检索和引用。

导入前确认这三点：

• 文档本身能正常打开、没有权限锁
• SiYuan 版本 ≥ 3.0.0（设置 → 关于 里可看）
• 复杂版式已尽量简化，页眉页脚、批注这类内容不保证完整保留

注意：Word 里失效的图片链接会导致导入后图片缺失，建议先在 Word 里把图片嵌入文档。

操作路径：

1. 点左侧导航栏文件 → 导入（快捷键Ctrl+I）
2. 在弹窗里选Word 文档（.docx）格式
3. 选中本地文件，点导入

丢进去的那一刻，标题已经变成 H1–H6 标题块，正文变文本块，表格变表格块，图片则自动落到assets目录成为图片块——之后就能享受全文检索、块引用这些能力了。

要交 Word 格式的稿子：笔记转 .docx 的路径

📌 场景：内容在 SiYuan 里写得顺手，但导师、客户只认 Word。

1. 打开目标笔记，点右上角⋮ → 导出
2. 选Word .docx（这个菜单项定义在 app/src/menus/commonMenuItem.ts 中，前端在 app/src/constants.ts 里把.docx标记为受支持的资产类型）
3. 按需配置导出选项：是否嵌入图片、是否保留格式、导出范围（当前文档 / 所选块 / 整个笔记本）
4. 点导出，选好保存位置即可

你的选择会被记下来，下次导出默认沿用这套设置，不用每次重配。

导出走的是 Pandoc 引擎，核心逻辑在 kernel/api/export.go 里。真正值得动的配置项都在 kernel/conf/export.go：是否给文档加标题（AddTitle）、是否连带导出子文档（IncludeSubDocs）、Pandoc 可执行文件路径与额外参数等。

导出翻车时查这 3 处

• 现象：导出报错提示 Pandoc 找不到原因：Pandoc 路径失效或未随包安装处理：到设置 → 高级重新指定 Pandoc 路径（对应配置项PandocBin）

• 现象：导入后格式错乱原因：Word 版本过高或版式过复杂处理：先在 Word 里另存为较旧版本，精简版式再导入

• 现象：导出文件打开异常或体积异常原因：笔记里残留无效引用、图片引用断裂处理：清理无效引用后重试；同时确认磁盘空间充足

别忘了：.docx也可以反过来作为资产直接拖进 SiYuan 保存，前端搜索索引里已把.docx列入可检索资产类型，导入成块和仅当附件存放是两条独立的路。

速查表

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan