showmd icon

showmd

showmd 是免費開源的 macOS Quick Look 擴充,讓你在 Finder 直接預覽 Markdown 檔案並顯示為已渲染內容,而非原始文字。支援 YAML frontmatter、渲染/原始切換、深色模式與其他 Markdown 功能。

showmd

總覽

showmd 是一個原生 macOS Quick Look 擴充,可在 Finder 中預覽 Markdown 檔案。它被定位為比內建 Preview app 更容易閱讀 .md 檔案的方式,以已渲染的 Markdown 取代原始來源文字。

預覽支援 YAML frontmatter、已渲染/原始切換、深色模式、語法高亮、數學、Mermaid 圖表、內嵌圖片,以及數種 Markdown 相關副檔名。網站說明它是開源、免費,並且需要 macOS 26(Tahoe)或更新版本。

功能

原生 Quick Look 預覽

作為 macOS Quick Look 擴充功能註冊,因此你可以在 Finder 中按空白鍵預覽 Markdown 檔案,使用系統預覽流程而不是開啟編輯器。

Frontmatter 渲染

將 YAML frontmatter 呈現為可收合的中繼資料表,且預設為收合,讓檔案中繼資料可供查看,又不會佔滿預覽畫面。

已渲染/原始切換

可在已渲染 Markdown 與原始來源之間切換,並可從已渲染檢視將檔案複製為 HTML。

完整 Markdown 渲染

支援 GitHub Flavored Markdown,包括表格、待辦清單、刪除線、圍欄程式碼區塊、警示、註腳、自動連結等。

語法高亮

以具語言感知的語法高亮顯示程式碼區塊,並且開箱支援 190 多種語言。

豐富預覽內容

處理行內與區塊 LaTeX 數學、Mermaid 圖表、相對圖片,以及常見的 Markdown 相關副檔名,例如 .md、.markdown、.mdx、.mdc、.rmd 和 .qmd。

使用情境

  • 在 Finder 中瀏覽 Markdown 檔案

    在 Finder 中以已渲染的版面預覽 .md 檔案,讓你不用開啟其他編輯器就能快速掃描內容。

  • 更清楚地閱讀指示檔

    以保留格式的方式檢視 AI 提示檔,例如 AGENTS.md、CLAUDE.md,以及類似的 Markdown 指示文件,而不是看到原始文字。

  • 檢閱結構化 Markdown 內容

    檢查依賴 frontmatter、圖表或數學的文件,並在 Quick Look 內直接看到這些元素被渲染。

  • 在已渲染與來源檢視間切換

    當你需要驗證格式或將檔案複製為 HTML 時,比較已渲染版本與原始來源。

Pros and Cons

Pros

  • 讓 Markdown 在 Finder 中保持可讀,而不用開啟編輯器。
  • 將 YAML frontmatter 顯示為可收合的中繼資料表。
  • 提供已渲染/原始切換與「複製為 HTML」動作。
  • 支援深色模式,並跟隨 macOS 外觀設定。
  • 涵蓋廣泛的 Markdown 功能,包括 GFM、數學、Mermaid 與語法高亮。

Cons

  • 需要 macOS 26(Tahoe)或更新版本。
  • 來源頁面除了說明產品為免費且開源之外,沒有提供更詳細的定價或授權說明。
  • 部分能力細節只出現在首頁,因此從現有來源無法完全確認長期文件與支援範圍。

FAQ

如何在 Finder 的快速查看中啟用 showmd?

下載 showmd,先開啟一次,然後在「系統設定」→「隱私權與安全性」→「延伸功能」→「快速查看」中啟用它。首次啟動時,macOS 可能會要求存取其他 App 的資料,讓 App 與擴充功能能共享設定。

YAML frontmatter 會如何處理?

showmd 會解析 YAML frontmatter 區塊,並將其渲染為可收合的中繼資料表,預設為收合狀態。來源說明顯示它支援一般值、帶引號字串、陣列,以及多行折疊區塊。

我可以在已渲染 Markdown 與原始來源之間切換嗎?

可以。每個預覽都包含「已渲染 / 原始」切換,而已渲染檢視也提供「另存為 HTML」選項。

showmd 支援深色模式嗎?

可以。showmd 會自動跟隨 macOS 外觀設定,而其設定也可讓你選擇「淺色」、「深色」或「自動」。

Quick Facts

類別
開發者工具
平台
macOS
主要用途
為 Markdown 檔案提供 Finder Quick Look 預覽
來源網域
showmd.yetanother.one
可用性
免費且開源
系統需求
macOS 26(Tahoe)或更新版本
showmd - AI Tool, Features, Use Cases & Alternatives | UStack