Markdown文件合并工具
功能说明
这个Python脚本可以将当前目录下的所有Markdown文件按顺序合并成一个完整的文档,并自动生成目录链接。
使用方法
- 确保Python环境已安装
- 在包含Markdown文件的目录中运行脚本:
python merge_md_files.py
脚本功能
🔍 智能排序
- 按文件名开头的数字进行排序(如:01_xxx.md, 02_xxx.md)
- 没有数字的文件会排在最后
📚 自动生成目录
- 从每个文件中提取标题作为目录项
- 生成可点击的锚点链接
- 支持中文标题的锚点生成
🔗 锚点链接
- 每个章节都有对应的锚点ID
- 目录中的链接可以直接跳转到对应章节
- 锚点格式:
<a id="章节名称"></a>
📄 输出格式
- 生成的文件名:
merged_cursor_docs.md
- 包含完整的文档标题和说明
- 每个章节之间用分隔线分开
运行 结果
脚本成功运行后会显示:
- 找到的Markdown文件数量
- 每个文件的处理状态
- 最终生成的文件信息
示例输出
🚀 开始合并Markdown文件...
==================================================
找到 57 个Markdown文件
处理文件: 01_GetStarted_01_Welcome_to_Cursor.md -> 欢迎使用 Cursor
✅ 已合并: 01_GetStarted_01_Welcome_to_Cursor.md
...
🎉 合并完成!
📄 输出文件: merged_cursor_docs.md
📊 合并了 57 个文件
📏 总行数: 3236
==================================================
✨ 脚本执行完成!
注意事项
- 脚本会自动跳过已生成的合并文件(
merged_cursor_docs.md
) - 如果文件中没有标题,会使用文件名作为标题
- 支持中文和英文标题的锚点生成
- 生成的文档大小约为110KB(基于57个文件)