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