Leaf：終端機裡的 Markdown 預覽器

我先在本機確認了一件事：leaf 已經安裝，而且版本是 leaf 1.19.1。

這篇不是在聊怎麼編輯 Markdown，而是在聊怎麼把 Markdown 看得更舒服。leaf 的定位很明確：它是終端機裡的 Markdown 預覽器，強項是把原始文件用接近 GUI 的方式呈現出來，讓你在純文字環境裡也能快速檢查排版。

最常用的打開方式

如果你常常先寫完草稿，再切到另一個視窗確認成品，leaf --watch 會很順手。它不會要求你改工作流，只是把「檢查結果」變得更即時。

寫 Hugo 文章時，leaf 特別好用的地方

1. frontmatter 直接變成表格

Hugo 文章最常見的 YAML frontmatter，在 leaf 裡會直接被整理成表格。title、date、categories、tags 一眼就能看懂，對常改文章的人很省事。

2. 表格、引用、清單都比純文字好讀

當文件裡有很多 Markdown 語法時，leaf 不只是顯示檔案，而是幫你把文件讀成已排版的樣子。這對 README、筆記、文章草稿都很實用。

3. 可以直接接其他 CLI 的輸出

如果要從 stdin 預覽，可以這樣：

echo '# Hello' | leaf

也可以把其他 CLI 的輸出接過來，例如：

claude "explain Rust lifetimes" | leaf

這種用法很適合臨時檢查 AI 產出的 Markdown 是否可讀。

常用快捷鍵

如果你習慣 Vim 式操作，幾乎不用學習成本。

設定與主題

leaf --config 會打開設定檔。最基本的設定看起來像這樣：

theme = "ocean"
editor = "nano"
watch = false

你也可以自訂主題檔，讓終端機配色跟你平常的工作環境一致：

theme = "/path/to/custom-theme.toml"

官方 README 也提到，leaf 支援主題切換、目錄導覽、搜尋、syntax highlighting，甚至連 LaTeX 都能處理。它不是花俏，而是把 Markdown 這件事做得很完整。

結論

leaf 很適合這幾種人：

• 常看 README 或技術文件的人
• 用終端機寫筆記、草稿、部落格的人
• 想快速確認 Markdown 排版的人
• 喜歡 TUI 工具的人

它的價值不是取代編輯器，而是補上「看文件」這一段。對我來說，這類工具通常不會天天被提起，但一旦裝好，就會一直留在工具箱裡。

如果你也常在終端機裡寫 Markdown，leaf 值得試試。

參考資料

• leaf GitHub Repository