返回首頁

Markdown Reader 幫助

快速了解所有功能,3 分鐘上手

快速入門 快速鍵 功能詳解 主題與外觀 圖表與公式 命令列工具 Quick Look 匯出 PDF 常見問題

快速入門

開啟檔案,開始閱讀,就這麼簡單

1. 開啟檔案或資料夾

按 ⌘O 或點擊工具列開啟按鈕,選擇 .md 檔案或資料夾。也可以直接將檔案或資料夾拖拽到視窗中。

2. 閱讀和導航

左側檔案樹瀏覽目錄結構,右側渲染檢視閱讀內容。點擊工具列大綱按鈕或按 ⌘\ 切換側邊欄。

3. 編輯與儲存

切換到原文模式(⇧⌘R)直接編輯,按 ⌘S 儲存。切換檔案時未儲存內容會自動保留。

4. 快速開啟檔案

按 ⌘P 開啟命令面板,輸入檔案名稱模糊搜尋,↑↓ 選擇,Enter 開啟。比瀏覽目錄樹更快。

快速鍵參考

鍵盤操作更高效

快速鍵功能
⌘O開啟目錄 / 檔案
⌘N新增檔案
⌘S儲存檔案
⌥⌘E匯出 PDF
⌘,開啟設定
⌘\切換側邊欄
⇧⌘E渲染模式
⇧⌘R原文模式
⌘+放大
⌘-縮小
⌘0實際大小
⌘F尋找
⌘G尋找下一個
⇧⌘G尋找上一個
⌥⌘F尋找與取代
⌘P命令面板

功能詳解

每個功能都為閱讀體驗而生

渲染檢視

cmark-gfm 引擎解析 Markdown,WKWebView 渲染為富文字。支援完整 GFM 擴展語法,包括表格、任務清單、刪除線、自動連結等。

原文編輯

按 ⇧⌘R 直接編輯 Markdown 原始碼,Prism.js 語法高亮支援 30+ 語言。⌘S 儲存,切換檔案自動保留未儲存內容。

檔案樹

遞迴瀏覽資料夾,鍵盤導航(方向鍵選擇,Enter 開啟)。右鍵選單提供新增、重新命名、移動、刪除等操作。

大綱導航

自動提取標題層級結構,點擊快速跳轉,閱讀長文件更高效。

尋找與取代

按 ⌘F 開啟尋找列。支援區分大小寫、全詞匹配、正規表示式。⌥⌘F 開啟尋找與取代。

檢視縮放

使用 ⌘+ / ⌘- 縮放內容,範圍 0.3x–3.0x。按 ⌘0 恢復實際大小,縮放級別自動恢復。

主題與外觀

33 套主題,打造你的閱讀空間

主題模式

在設定 → 外觀中,可選擇淺色、深色或跟隨系統三種模式,應用程式立即切換外觀。

配色方案

33 套預設配色(20 深色 + 13 淺色),Dracula、Catppuccin、Nord、Tokyo Night……每種模式有獨立配色。

自訂顏色

在設定 → 外觀 → 自訂顏色中,可單獨調整背景色、文字色、強調色、成功色、危險色。

對比度調節

提供低/高兩檔對比度選項,調整背景與前景層之間的視覺對比。

圖表與公式

技術文件的完美渲染

Mermaid 圖表

在程式碼區塊中使用 `mermaid` 語言標識,即可渲染流程圖、時序圖、甘特圖等。本機渲染,無需網路。

數學公式 (KaTeX)

使用 `$...$` 包裹行內公式,`$$...$$` 包裹區塊公式。LaTeX 語法完美呈現。

PlantUML 圖表

在程式碼區塊中使用 `plantuml` 語言標識,自動渲染為 SVG 圖表。需要網路連線。

命令列工具 mdr

終端機工作流程無縫銜接

安裝

開啟 設定 → 一般 → 命令列工具,點擊「安裝」按鈕。安裝完成後,`mdr` 命令即可在終端機中使用。

使用

終端機輸入 `mdr README.md` 即可開啟檔案,支援同時開啟多個檔案和資料夾。

更多功能

還有這些貼心功能等你發現

Quick Look 預覽

在 Finder 中選取 .md 檔案按空白鍵,即可預覽渲染效果。需在 設定 → 一般 → Quick Look 預覽 中啟用。

匯出 PDF

按 ⌥⌘E 或使用選單 檔案 → 匯出 PDF,將渲染內容匯出為 PDF 檔案,保留目前主題樣式。

常見問題

遇到問題?先看看這裡

支援哪些檔案格式?

支援 `.md`、`.markdown`、`.mdown`、`.mkd` 等 Markdown 格式檔案。

系統需求是什麼?

macOS 26 (Tahoe) 或更高版本。

PlantUML 圖表無法渲染?

PlantUML 渲染需要網路連線,請確保可以存取 PlantUML 伺服器。如果處於離線環境,Mermaid 圖表仍可正常使用(本機渲染)。

如何設定 Markdown Reader 為預設開啟程式?

開啟 設定 → 一般 → 預設 Markdown 開啟程式,點擊「設為預設」即可。也可以右鍵 .md 檔案 → 顯示簡介 → 開啟方式 → 選擇 Markdown Reader → 點擊「全部更改」。

如何回饋問題或建議?

歡迎在 GitHub Issues 中提交回饋。