showmd

showmd 是什麼？

showmd 是 macOS 的免費 Quick Look 擴充功能，能以比 Finder 預設方式更易讀的形式預覽 Markdown 檔案（.md 及相關副檔名）。其核心目的是渲染帶格式的 Markdown，同時保留原始內容的存取。

在 Finder 中按空白鍵檢視 .md 檔案時，不再顯示純文字，showmd 會渲染 Markdown 並提供渲染/原始切換。它還會將 YAML frontmatter 解析為可摺疊的中繼資料表格，支援依賴 Markdown 結構的常見文件與 AI 提示工作流程。

主要功能

• Finder 中的 Markdown Quick Look 預覽：在 Markdown 檔案上按空白鍵，即可查看格式化輸出，無需開啟瀏覽器或編輯器。
• 渲染 ↔ 原始切換：單鍵切換渲染 Markdown 與原始 Markdown 原始碼。
• YAML frontmatter 作為可摺疊中繼資料表格：偵測 frontmatter 中的「找到的鍵值」，預設摺疊顯示為表格。
• Markdown 解析器支援的 Markdown 功能：支援 GitHub Flavored Markdown 元素，如表格、任務清單、刪除線、自動連結、註腳等。
• 程式碼與特殊內容的語法感知渲染：程式碼區塊使用語言感知高亮（列出 190+ 語言），內嵌與區塊 LaTeX 數學經 KaTeX 渲染，Mermaid 圖表從程式碼區塊渲染。
• AI 導向的標籤渲染：AI 提示中常見的自訂 XML 風格標籤（例如 、、）渲染為帶標籤與邊框的區塊，而非純角括號。
• 無雲端或背景上傳：頁面說明「No cloud. No uploads. No telemetry」，表示檔案預設本地預覽。
• Quick Look 中的內嵌圖片處理：相對圖片路徑正確解析，讓本機螢幕截圖/圖表能在預覽中顯示。

如何使用 showmd

1. 下載 macOS 版 showmd 並開啟一次。
2. 在 系統設定 → 隱私權與安全性 → 擴充功能 → Quick Look 中啟用 showmd（頁面描述為單一切換）。
3. 在 Finder 中選取 Markdown 檔案並按空白鍵，即可用 showmd 預覽。
4. 使用渲染/原始切換在格式化輸出與底層 Markdown 間切換。頁面也提及可複製為 HTML 的選項。

使用情境

• 閱讀以 Markdown 儲存的文件：預覽 README 檔案，包含格式化標題、清單、連結與表格，無需離開 Finder。
• 檢查以 Markdown 撰寫的 AI 提示/設定檔：檢視 AI 代理指令檔案，內容含 XML 風格標籤，標籤渲染為標示區塊以利快速掃描。
• 審閱靜態網站內容中的 YAML frontmatter：需要時展開 frontmatter 表格檢查標題或設定鍵值，平時閱讀則保持摺疊。
• 檢查含程式碼、數學或圖表的技術內容：查看語法高亮的程式碼區塊、LaTeX 運算式與 Mermaid 流程圖的內嵌渲染，而非純文字。
• 驗證本機筆記/專案文件中的相對圖片：確認相對路徑引用的圖片在 Quick Look 預覽中正確顯示。

常見問題

如何在 Finder 中啟用 showmd？
下載 showmd、開啟一次，然後前往 系統設定 → 隱私權與安全性 → 擴充功能 → Quick Look 啟用擴充功能。首次啟動時，macOS 可能提示允許存取其他應用程式資料；點擊允許。

showmd 是否取代開啟瀏覽器的需求？
頁面將 showmd 定位為直接在 macOS Quick Look 中預覽 Markdown 的方式，而非需開啟瀏覽器查看渲染輸出。

能否在渲染輸出與原始 Markdown 間切換？
可以。showmd 提供渲染與原始切換，描述為單鍵操作。

showmd 如何處理 YAML frontmatter？
它將 YAML frontmatter 解析為可摺疊表格，預設摺疊，可展開檢視中繼資料。

是否有雲端元件？
頁面說明「No cloud. No uploads. No telemetry」，表示預覽預設本地處理。

替代方案

• 在專用 Markdown 檢視器/編輯器中開啟 Markdown 檔案：使用專為 Markdown 渲染與匯出設計的應用程式。這些選項通常包含更多編輯工具，而 showmd 則專為 Quick Look 預覽設計。
• 使用基於瀏覽器的 Markdown 渲染器：上傳或貼上內容至線上檢視器以取得渲染輸出。相較 showmd，這增加了瀏覽器步驟，且可能無法嚴格保持檔案本地。
• 依賴 macOS Quick Look 預設：Finder 的空間預覽會顯示原始 Markdown 原始碼。這最簡單，但對表格、圖表與數學等格式化內容可讀性較差。
• 使用文件/靜態網站工具鏈預覽內容：本機開發伺服器可搭配完整網站樣式渲染 Markdown，但通常比 Quick Look 預覽工作流程更耗資源。