digtools
📑
markdown toc generator,

Markdown 目錄產生器

從 Markdown 文字自動產生目錄 (TOC) 的免費工具。可自訂標題層級與列表格式。完全在您的瀏覽器內運作,確保隱私安全。

自動產生目錄
只需貼上即可立即建立目錄
🛠️
高度可自訂
可選擇標題層級與列表格式
🔒
安全處理
完全在您的瀏覽器中執行,不需上傳至伺服器
about,

關於 Markdown 目錄產生器

這是一個免費工具,能自動為 Markdown 撰寫的文件產生目錄(TOC:Table of Contents)。在撰寫 GitHub README 或部落格等平台的技術文章時,能為您省去手動建立目錄的麻煩。

您可以精細自訂擷取的標題層級(h1-h6)以及輸出格式,例如無序列表 (-) 或有序列表 (1.)。

所有處理皆在您的瀏覽器內完成,因此您輸入的文字資料絕不會被傳送至外部伺服器。您可以安全地將其用於機密文件或私人筆記,而不必擔心資訊外洩。

how to,

使用方法

STEP 1

輸入 Markdown

在左側輸入區貼上或輸入您要建立目錄的 Markdown 文字。

STEP 2

設定選項

選擇要擷取的「最大標題層級 (h2-h6)」以及要輸出的「列表格式(無序 / 有序)」。

STEP 3

產生與複製目錄

點擊「產生目錄」按鈕,目錄將會輸出在右側區域。點擊複製按鈕將其貼到您的原始文件中。

glossary,

詞彙表

Markdown
一種用於格式化文字的輕量級標記語言。它使用符號來輕鬆表示標題、列表、連結等,並廣泛應用於程式設計師之間。
TOC(目錄,Table of Contents)
放置在長篇文件開頭,讓讀者能快速訪問所需章節,進而提升閱讀體驗。
標題層級(Heading Level)
文件階層結構的指標,對應於 HTML 的 h1 到 h6 標籤。在 Markdown 中,層級由 "#" 的數量來表示。
錨點連結(Anchor Link)
用於跳轉到頁面內特定位置的連結。在 Markdown 目錄中,它是透過指定根據標題文字自動產生的 ID(例如 `#heading`)來進行跳轉。
客戶端處理(Client-side Processing)
一種僅在使用者的瀏覽器內執行程式而不與伺服器通訊的機制。它沒有資料外洩的風險,並提供卓越的安全性。
faq,

常見問題

Q.我輸入的 Markdown 資料會儲存到伺服器上嗎?
不會。這個工具採用純客戶端(Client-side)處理,所有操作都在您的瀏覽器中執行,您輸入的文字絕不會傳送到外部伺服器。即使是包含機密資訊的文件,也能安心使用。
Q.為什麼點擊產生的目錄連結沒有跳轉?
根據不同平台(如 GitHub 等),從標題自動產生錨點 ID 的規則可能會有所不同。本工具基於常見規則(轉為小寫、將空格替換為連字號等)來產生 ID,但您可能需要根據特定平台的規範手動進行調整。
Q.可以從目錄中排除特定的標題嗎?
在目前版本中,會擷取所有小於或等於您指定之「最大標題層級」的標題。目前不支援僅排除特定標題的功能,請在產生後手動刪除。
Q.程式碼區塊(Code blocks)內的 '#' 也會被擷取嗎?
不會。我們的擷取演算法已設計為忽略被三個反引號(```)包圍的程式碼區塊內的文字。因此,程式碼中的註解不會被錯誤地擷取為目錄。
Q.支援非英文的標題嗎?
支援。包含日文、繁體中文、英文及其他語言的標題都能正確被擷取並產生為目錄。不過,由於錨點連結 ID 的產生規則主要基於英文,非英文標題在某些情況下可能會被進行 URL 編碼。
use cases,

使用情境

🐙

撰寫 GitHub README

為開源專案較長的 README.md 檔案新增目錄,讓貢獻者與使用者更容易尋找資訊。

📝

撰寫技術部落格

在各大平台發布長篇技術文章時,在開頭放置目錄以提升讀者的便利性。

📚

整理內部文件

為使用 Notion 等支援 Markdown 的工具建立的內部手冊新增目錄,以提升搜尋效率和可讀性。

📓

整理個人筆記

為在 Obsidian 或 Logseq 等知識管理工具中累積的大量筆記新增目錄,讓您順利整理思緒並進行複習。

發送反饋

請告訴我們您的想法,以幫助我們改進工具。

免責聲明

本網站提供的所有工具均可免費使用,但請用戶自行承擔使用風險。本網站對各種工具的計算結果、轉換結果及生成數據的準確性、完整性和安全性不作任何保證。因使用本工具而產生的任何損害或糾紛,運營者概不負責,敬請見諒。此外,檔案處理與計算等操作原則上均在您的瀏覽器內完成,您輸入的數據不會傳送或保存在本網站的伺服器上。