跳至主要内容

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個檔案)