Obsidian 是一款基于普通 Markdown 文件构建的强大笔记工具。如果您有多年以 Word 格式存储的笔记、报告或文档，将它们转换为 Markdown 可以让您将所有内容放入您的 Obsidian 库中。本指南介绍了最佳工作流程 黑曜石之言 转换。
为什么将 Word 文档移至 Obsidian？
Obsidian 的核心优势是将音符连接在一起。一旦您的内容处于 Markdown 格式，您就可以：
- 创建
[[wikilinks]]相关注释之间 - 查看反向链接 — 每一条提及当前注释的注释
- 构建相互关联的想法的知识图
- 使用社区插件进行间隔重复、任务、模板等
- 将所有内容保存在纯文本文件中，这将比任何应用程序更耐用
将 Word 文档转换为 Markdown
最快的方法是 WordToMD:
- 打开转换器并将 .docx 文件拖到上面
- Review the Markdown output on the right
- 下载 .md 文件
输出保留了标题、粗体/斜体、列表、表格和超链接——正是 Obsidian 所需要的。
添加哪些黑曜石特定格式
初始转换后，您需要添加黑曜石特定的元素： 语言标识符后面的
YAML 前沿问题
Obsidian 支持元数据的 YAML frontmatter：
---
title: "Project Proposal"
date: 2026-05-23
tags: [project, planning, Q2]
status: active
---将此块添加到转换后的 .md 文件的最顶部。Obsidian 读取这些属性并使其可通过“属性”面板进行搜索。
维基链接
外部超链接从 Word 转换如下：
See the [project plan](https://docs.example.com/plan)对于 Obsidian 中的内部注释参考，替换或添加 wiki 链接： Jekyll 的
See [[Project Plan]] for details.您可以使用两种格式 - Obsidian 处理标准 Markdown 链接及其自己的链接 [[wikilink]] 语法。
标签
在 Obsidian 中，标签写为 #tagname 内联或列在前面。转换后添加相关标签，将注释集成到您的保管库的标签系统中。
处理标题
Obsidian 的大纲面板和标题搜索在标题遵循逻辑层次结构时效果最佳。转换后，验证您的标题级别：
# Document Title (H1 — one per file)
## Section One (H2)
### Subsection (H3)
## Section Two (H2)见 Markdown 标题指南 有关标题层次结构的规则。
黑曜石表格
Obsidian 渲染标准 GFM 表。Word 文档中的表格将通过以下方式正确转换 WordToMD. Example:
| Meeting | Date | Outcome |
|---|---|---|
| Q1 Review | 2026-03-01 | Budget approved |
| Strategy | 2026-04-15 | Roadmap updated |对于具有合并单元格或嵌套内容的复杂表格，您需要手动简化它们。阅读 Markdown 表：完整指南 适用于黑曜石特定的表格提示。
图像
Word 文档中嵌入的图像不会自动保留。转换后：
- 从 Word 导出图像：另存为 → 网页（已过滤）— Word 将图像保存到单独的文件夹
- 将图像文件复制到黑曜石保管库的附件文件夹中
- 在笔记中添加图像引用：
![[meeting-diagram.png]]黑曜石使用自己的 ![[filename]] 库中图像的语法，或标准 Markdown .
批量导入：转换多个 Word 文件
如果您要迁移大型文档库：
- 一次转换一个文件 WordToMD （免费，无限制）
- 将每个 .md 文件保存到您的 Vault 目录
- 对于数十或数百个文件，请参阅 批量将 Word 转换为 Markdown
批量导入后，使用 Obsidian 的搜索来查找应该链接在一起的注释，并逐步添加 wiki 链接。
常见问题
粗体文本未在黑曜石中呈现
黑曜石的用途 **bold** 语法。如果您的 Word 文档在没有正确映射的情况下手动将文本加粗，请检查输出中是否有任何未转换的格式。
显示原始管道字符而不是渲染的表格
确保您在 Obsidian 中以阅读模式（而不是编辑模式）查看文件，或者检查表格是否至少有一个标题行分隔符 (|---|---|).
标题全部显示为同一级别 Word 文档使用手动文本格式而不是标题样式。在 Word 中打开原件，应用标题样式，然后重新转换。
FAQ
我可以转换 .doc 文件（旧 Word 格式）吗？ 首先将它们另存为 .docx（文件 → 另存为 → Word 文档），然后进行转换。
Obsidian 是否支持 WordToMD 生成的所有 Markdown 语法？ 是的。Obsidian 支持 CommonMark 和 GFM 扩展，这就是 WordToMD 的输出。
如何保留文档的内部部分链接？
Word 书签不能直接转换。转换后，将书签链接替换为黑曜石标题锚： [[Note Name#Section Heading]].
Word 中的标注框怎么样？ 它们在 Markdown 中转换为块引用。Obsidian 有自己的标注语法，您可以使用它：
> [!note]
> This is a note callout in Obsidian.结论
转换 Word 到黑曜石 Markdown 是一个两步过程：使用 WordToMD 获得干净的 Markdown，然后添加黑曜石特定的元素，如 frontmatter、wikilinks 和标签。一旦您的文档进入您的保管库，Obsidian 的链接和搜索功能就会将静态文档转换为互联的知识库。