Skip to main content

Markdown文件合并工具

功能说明

这个Python脚本可以将当前目录下的所有Markdown文件按顺序合并成一个完整的文档,并自动生成目录链接。

使用方法

  1. 确保Python环境已安装
  2. 在包含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个文件)
365/年

CursorAI编程知识星球

我的cursor教学视频已经超100万人观看,可能是中文互联网最佳了

立即查看800+人已加入
免费

通过Monica免费使用满血可联网DeepSeek R1

Monica接入DeepSeek R1、OpenAI o1、GPT-4o、Claude 3.5 和 Gemini 1.5,来提升您的聊天、搜索、写作和编程体验。

立即查看一站式 AI 助手