工具说明
Markdown 合并会按顺序连接多个 `.md` 文档，同时保留原始 Markdown 文本。标题、引用链接、脚注和代码围栏依赖整份文档的上下文，同名引用或未闭合代码块可能影响后续文件的渲染。
工具不会自动重写相对图片路径、标题层级或目录锚点。合并仓库文档时，应以最终文件位置为基准修正资源链接，并在实际使用的 Markdown 渲染器中预览。
使用步骤
检查每个文件边界
确认代码围栏、HTML 标签和列表已经闭合。
排列并设置间隔
按阅读顺序放置文件，确保章节之间有足够换行。
预览最终 Markdown
检查标题层级、相对链接、图片、脚注和目录锚点。
支持范围与限制
- 输入 / 输出
- 多个 .md 文件，输出单个 Markdown
- 拼接方式
- 按列表顺序相接，文件之间留出空行，避免相邻段落被解析成同一段
- 标题层级
- 不做重编号。各文件若都从 # 一级标题开始，合并后会出现多个一级标题，通常需要手工降级
- 相对链接与图片
- 路径原样保留。源文件分处不同目录时，合并后相对路径大概率失效
- front matter
- 各文件顶部的 YAML front matter 会作为正文文本保留，需要自行清理
- 后续处理
- 可接 Markdown 转 PDF 或 Markdown 转 HTML 直接产出交付件
典型使用场景
组合项目文档
把安装、使用和参考章节连接成单一 README 或手册源文件。
汇总写作草稿
按章节顺序合并多个 Markdown 笔记，进入统一编辑。
把分章节的文档拼成一篇
按章节分开写的 Markdown 合并成完整文稿，再一次性转成 PDF 或 HTML 交付。
使用前需要知道的事
- 相对链接不会自动根据新文件路径调整。
- 重复的引用定义、脚注 ID 或 HTML 锚点可能互相覆盖。
- 不同平台的 Markdown 方言不完全一致，应在目标平台验证。
相关概念
- fenced code block
- 由成对反引号或波浪号界定的多行代码区域。
- relative link
- 相对于当前 Markdown 文件位置解析的资源路径。