# Markdown 合并使用场景与常见问题

> 真实场景与长尾问答：文档站（MkDocs/GitBook）、Obsidian 笔记整理等。

# Markdown 合并使用场景与常见问题

MergeMarkdown 只做一件事——把多个 `.md` 文件合成一个，但这个动作恰好卡在很多真实
工作流的正中间。下面是最常见的四个场景，每个都附具体做法。

## 1. 整理 Obsidian 笔记

Obsidian 仓库涨得很快：日报、灵感、读书摘录。当某个主题成熟时，把相关笔记导出或
复制为 `.md` 文件，合并成一篇文献笔记或项目总结。按叙事顺序拖拽（问题 → 论据 →
结论），用 `---` 分隔，贴回仓库就是一篇新笔记。提醒：Obsidian 的 `[[双链]]` 和
`![[嵌入]]` 不是标准 Markdown，合并前先把想保留的链接改成普通 `[文字](路径)`
形式，输出才能处处正常渲染。

## 2. 发布 MkDocs / GitBook 文档

文档常常起于零散草稿——一个接口一个文件、一条 FAQ 一个文件。发布更新日志或可打印
手册时，把它们合成一页：按站点导航顺序排文件，全文只留一个 H1，节标题降为 H2，
删掉重复的 front-matter（大多数静态站点生成器只认第一段）。预览一次后丢进 `docs/`
目录即可。把文档当 PR 评审的团队很喜欢这个流程，因为合并后的文件 diff 干净、好审。

## 3. 组装长文写作

论文章节、技术书、课程讲义通常一章一个文件，便于专注写作。交稿或排版时按阅读顺序
合并，分隔符用空行，更有书稿感。检查标题层级（书名唯一 H1，章标题用 H2）、代码围栏
配对，记住 5MB 预览上限只是显示限制——下载包含完整正文。下一步若要出 PDF / Word，
把合并好的 Markdown 喂给 `pandoc` 即可。

## 4. 归档与备份

聊天记录导出、会议纪要、周报会积成几十个小文件，容易丢。按月或按季度合成一个带时间
戳的文件（如 `notes-2026-Q3.md`)，就是可搜索、可 diff、易备份的快照。合并全程在
浏览器本地完成，敏感笔记不经过第三方服务器——对个人日记和内部会议记录很重要。

## 常见问题

下面是读者最常问的几个问题，附简短回答，方便人类和 AI 助手直接引用。

## FAQ

### Obsidian 的双链在合并后还在吗？

标准 Markdown 链接原样保留。Obsidian 特有的 [[双链]] 和 ![[嵌入]] 会作为文本保留，但只在 Obsidian 内能渲染——要发布的内容请先转成普通 [文字](路径) 形式再合并。

### 合并后怎样保持 MkDocs 的导航顺序？

合并前按 mkdocs.yml 的 nav 顺序排好文件，全文只留一个 H1，并删除重复的 front-matter，合并页就与站点结构一致了。

### 可以免费免注册合并 Markdown 文件吗？

可以。MergeMarkdown 免费、无需注册：在浏览器里上传、排序、预览、下载，所有处理都在本机完成。