分类

← View All Tools

Markdown文件合并工具

合并多个Markdown文件，智能调整标题层级并生成目录

Click to upload files or drag and drop files here

Maximum file size: 20MB Maximum files: 10
Supported formats: text/markdown, .md, .markdown, text/plain

关键信息

分类
Data Processing
输入类型
file, select
输出类型
file
样本覆盖
4
支持 API
Yes

概览

Markdown文件合并工具是一款高效的文档处理工具，支持将多个Markdown文件快速合并为一个完整文档，并提供智能标题层级调整与目录生成功能，助您轻松管理和整合碎片化文档。

适用场景

  • •需要将分散的章节或笔记合并为一份完整的技术文档或电子书时。
  • •在整理项目文档时，希望统一调整各文件的标题层级以保持结构一致性。
  • •需要为合并后的长文档自动生成目录，以便于快速导航和阅读时。

工作原理

  • •上传您需要合并的多个Markdown文件，支持批量选择。
  • •根据需求选择合并策略（如智能调整或层级嵌套）及标题处理方式。
  • •开启目录生成选项，点击执行即可获得合并后的完整Markdown文件。

使用场景

技术文档编写：将多个模块的API说明文档合并为一份完整的开发手册。
个人知识库整理：将分散的读书笔记或学习心得按主题合并为长篇文档。
项目报告汇总：将不同成员提交的Markdown格式周报合并为一份月度总结报告。

用户案例

1. 合并项目开发手册

技术文档工程师
背景原因
项目组有5个独立的Markdown文件，分别描述了后端、前端、数据库、部署和测试流程。
解决问题
需要将这些文件合并成一份统一的《项目开发手册》，并要求标题层级自动对齐，同时生成目录。
如何使用
上传5个md文件，选择“智能合并”策略，设置标题处理为“调整层级”，并开启“生成目录”。
示例配置
mergeStrategy: smart, headerHandling: adjust, generateToc: yes
效果
生成了一份结构严谨、带有自动目录的完整开发手册，所有标题层级已自动优化。

2. 整理个人学习笔记

学生
背景原因
积累了多篇关于Python学习的Markdown笔记，文件标题层级混乱，且没有统一的索引。
解决问题
希望将所有笔记合并，并将所有标题统一扁平化为H1和H2，方便快速浏览。
如何使用
上传所有笔记文件，选择“简单合并”策略，设置标题处理为“扁平化”，并开启“添加文件头”。
示例配置
mergeStrategy: concatenate, headerHandling: flatten, addFileHeaders: yes
效果
得到了一份包含所有笔记内容的单一文件，每个章节前均有清晰的文件名标识，且标题层级整齐划一。

用 Samples 测试

markdown, text, file
Markdown 示例
Markdown 格式示例，从简单到复杂的文档结构
title token markdown
markdown, text
Markdown 链接提取示例
包含各种链接类型的 Markdown 示例文档，用于测试 Markdown 链接提取工具
title token markdown
markdown, text
Markdown 幻灯片示例
用于测试 PDF 导出的 Remark/Marp 风格 Markdown 幻灯片
title token markdown
markdown, text
Test Pyramid Examples - 测试策略指导
全面的测试金字塔实现示例，包括单元测试、集成测试、端到端测试、测试组织和平衡软件质量保证的战略测试模式
preferred input family markdown,text
markdown, text

相关专题

Markdown 工具专题
探索 9 个围绕 markdown 的 utility 工作流工具，快速找到相近能力。
TextConvert工具专题
探索 80 个围绕 text 的 convert 工作流工具，快速找到相近能力。
Text 工具专题
探索 33 个围绕 text 的 utility 工作流工具，快速找到相近能力。
MarkdownConvert工具专题
探索 15 个围绕 markdown 的 convert 工作流工具，快速找到相近能力。

常见问题

该工具支持合并多少个文件？

单次操作最多支持上传10个Markdown文件，总大小限制在20MB以内。

什么是智能标题调整？

智能调整会自动根据合并顺序，重新计算各文件的标题层级，确保合并后的文档结构逻辑清晰。

合并后的文档可以保留原有的内部链接吗？

可以，工具支持保留内部链接，并会在必要时自动进行路径调整以确保链接有效。

是否可以为每个合并的文件添加文件头？

是的，您可以选择开启添加文件头功能，以便在合并后的文档中区分不同来源的内容。

生成的目录支持跳转吗？

支持，生成的目录基于Markdown标准语法，在大多数Markdown编辑器和阅读器中均可实现点击跳转。

API 文档

请求端点

POST /zh/api/tools/markdown-merger

请求参数

参数名 类型 必填 描述
mdFiles file (需要先上传) 是 -
mergeStrategy select 是 -
headerHandling select 是 -
generateToc select 是 -
preserveLinks select 是 -
addFileHeaders select 是 -

文件类型参数需要先通过 POST /upload/markdown-merger 上传获取 filePath，然后将 filePath 传递给对应的文件字段。

响应格式

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
文件: 文件

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中： 

{
  "mcpServers": {
    "elysiatools-markdown-merger": {
      "name": "markdown-merger",
      "description": "合并多个Markdown文件，智能调整标题层级并生成目录",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=markdown-merger",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具，比如：`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`，最多20个。

支持 URL 文件链接或 Base64 编码作为文件参数。

如果遇见问题，请联系我们：[email protected]