Markdown 目錄產生器
從 Markdown 文字自動產生目錄 (TOC) 的免費工具。
可自訂標題層級與列表格式。完全在您的瀏覽器內運作,確保隱私安全。
關於 Markdown 目錄產生器
這是一個免費工具,能自動為 Markdown 撰寫的文件產生目錄(TOC:Table of Contents)。在撰寫 GitHub README 或部落格等平台的技術文章時,能為您省去手動建立目錄的麻煩。
您可以精細自訂擷取的標題層級(h1-h6)以及輸出格式,例如無序列表 (-) 或有序列表 (1.)。
所有處理皆在您的瀏覽器內完成,因此您輸入的文字資料絕不會被傳送至外部伺服器。您可以安全地將其用於機密文件或私人筆記,而不必擔心資訊外洩。
使用方法
輸入 Markdown
在左側輸入區貼上或輸入您要建立目錄的 Markdown 文字。
設定選項
選擇要擷取的「最大標題層級 (h2-h6)」以及要輸出的「列表格式(無序 / 有序)」。
產生與複製目錄
點擊「產生目錄」按鈕,目錄將會輸出在右側區域。點擊複製按鈕將其貼到您的原始文件中。
詞彙表
- Markdown
- 一種用於格式化文字的輕量級標記語言。它使用符號來輕鬆表示標題、列表、連結等,並廣泛應用於程式設計師之間。
- TOC(目錄,Table of Contents)
- 放置在長篇文件開頭,讓讀者能快速訪問所需章節,進而提升閱讀體驗。
- 標題層級(Heading Level)
- 文件階層結構的指標,對應於 HTML 的 h1 到 h6 標籤。在 Markdown 中,層級由 "#" 的數量來表示。
- 錨點連結(Anchor Link)
- 用於跳轉到頁面內特定位置的連結。在 Markdown 目錄中,它是透過指定根據標題文字自動產生的 ID(例如 `#heading`)來進行跳轉。
- 客戶端處理(Client-side Processing)
- 一種僅在使用者的瀏覽器內執行程式而不與伺服器通訊的機制。它沒有資料外洩的風險,並提供卓越的安全性。
常見問題
- Q.我輸入的 Markdown 資料會儲存到伺服器上嗎?
- 不會。這個工具採用純客戶端(Client-side)處理,所有操作都在您的瀏覽器中執行,您輸入的文字絕不會傳送到外部伺服器。即使是包含機密資訊的文件,也能安心使用。
- Q.為什麼點擊產生的目錄連結沒有跳轉?
- 根據不同平台(如 GitHub 等),從標題自動產生錨點 ID 的規則可能會有所不同。本工具基於常見規則(轉為小寫、將空格替換為連字號等)來產生 ID,但您可能需要根據特定平台的規範手動進行調整。
- Q.可以從目錄中排除特定的標題嗎?
- 在目前版本中,會擷取所有小於或等於您指定之「最大標題層級」的標題。目前不支援僅排除特定標題的功能,請在產生後手動刪除。
- Q.程式碼區塊(Code blocks)內的 '#' 也會被擷取嗎?
- 不會。我們的擷取演算法已設計為忽略被三個反引號(```)包圍的程式碼區塊內的文字。因此,程式碼中的註解不會被錯誤地擷取為目錄。
- Q.支援非英文的標題嗎?
- 支援。包含日文、繁體中文、英文及其他語言的標題都能正確被擷取並產生為目錄。不過,由於錨點連結 ID 的產生規則主要基於英文,非英文標題在某些情況下可能會被進行 URL 編碼。
使用情境
撰寫 GitHub README
為開源專案較長的 README.md 檔案新增目錄,讓貢獻者與使用者更容易尋找資訊。
撰寫技術部落格
在各大平台發布長篇技術文章時,在開頭放置目錄以提升讀者的便利性。
整理內部文件
為使用 Notion 等支援 Markdown 的工具建立的內部手冊新增目錄,以提升搜尋效率和可讀性。
整理個人筆記
為在 Obsidian 或 Logseq 等知識管理工具中累積的大量筆記新增目錄,讓您順利整理思緒並進行複習。
發送反饋
請告訴我們您的想法,以幫助我們改進工具。
Feedback is temporarily suspended
The server is busy or spam protection is active. Please try again later.