支援

歡迎透過 [email protected] 提出問題、回報錯誤或提出功能建議。

常見問題

按下空白鍵仍然只顯示純文字

快速查看延伸功能必須先啟用，macOS 才會使用它們：

1. 把 qlmd 移到「應用程式」檔案夾，並開啟一次
2. 開啟系統設定 → 一般 → 登入項目與延伸功能
3. 在延伸功能清單中找到快速查看，確認 qlmd 已開啟
4. 關閉預覽，再按一次空白鍵

如果仍然只顯示純文字，請在終端機執行 qlmanage -r 重新載入快速查看產生器，或登出後重新登入。

qlmd 可以預覽哪些檔案？

副檔名為 .md、.markdown、.mdown 與 .mkd 的檔案。

我改了一項設定，但預覽看起來沒變

設定會從下一次預覽開始套用。請關閉快速查看視窗，再按一次空白鍵。macOS 也會依檔案快取預覽——如果你已經看過的文件仍顯示舊樣式，請在終端機執行 qlmanage -r cache。

我的程式碼區塊沒有醒目提示

qlmd 內建一組精選語言（Swift、JavaScript、TypeScript、Python、Bash、JSON、YAML、XML/HTML、CSS、Go、Rust、C、Java、Ruby、SQL、diff 與 Markdown，外加常見的別名）。不在這份清單中的語言會以純文字顯示，不會加上醒目提示。請告訴我們你需要哪種語言，我們會考慮加入。

Mermaid 圖表顯示為程式碼

請確認 qlmd App 的 Extensions 分頁中 Mermaid 已開啟。如果已經開啟，圖表的原始碼可能不是有效的 Mermaid 語法——在 GitHub 上繪製同一份文件也會出現相同的問題。

文件中的圖片沒有出現

以相對路徑參照的圖片，會依文件所在的資料夾來解析。如果檔案被移動或重新命名，qlmd 會顯示替代文字而不是圖片。遠端圖片（http:// / https://）不會被載入：預覽功能在設計上就被封鎖、無法建立網路連線。

要如何匯出 PDF 或 HTML 檔案？

在 qlmd App 中開啟文件——快速查看預覽本身沒有選單列——接著選擇 File → Export as PDF… 或 Export as HTML…。PDF 會是與文件等高的單一連續頁面，而不是一疊依紙張大小分頁的文件，其中的文字也保持可選取。HTML 檔案內含自身樣式並嵌入所用的圖片，因此可以單獨在任何地方開啟。

支援哪些 macOS 版本？

qlmd 需要macOS 15（Sequoia）或以上版本。你可以在Apple 選單 → 關於這台 Mac查看你的系統版本。

qlmd 會把我的文件傳送到任何地方嗎？

不會。所有繪製作業都在你的 Mac 上完成，預覽功能無法建立網路連線。詳情請參閱隱私權政策。

還是沒解決？

請寄信到 [email protected]，並附上你的 macOS 版本、qlmd 版本（在 App 的 About 分頁查看），以及如果方便的話，出問題的 Markdown 檔案。