Markdown 的花式cat
(即 CommonMark):
$ mdcat sample.md
WezTerm 中的 mdcat,使用「One Light (base16)」、「Gruvbox Light」和「Darcula (base16)」(從左到右),字體為 JetBrains Mono。
mdcat
與 iTerm2、WezTerm 和 kitty 配合使用效果最好,並且是帶有斜體字元的良好終端字體。然後它
終端 | 基本文法 | 語法高亮 | 圖片 | 跳躍標記 |
---|---|---|---|---|
基本 ANSI 1 | ✓ | ✓ | ||
Windows 10 控制台 | ✓ | ✓ | ||
術語 | ✓ | ✓ | ✓ | |
iTerm2 | ✓ | ✓ | ✓3 | ✓ |
貓咪 | ✓ | ✓ | ✓3 | |
韋茲術語 | ✓ | ✓ | ✓3 | |
VS程式碼 | ✓ | ✓ | ✓3 | |
幽靈般的 | ✓ | ✓ | ✓3 |
不支援:
嘗試mdcat --help
或閱讀 mdcat(1) 線上說明頁。
cargo install mdcat
手動建立mdcat
(詳細資訊請參閱下文)。 mdcat
可以連結或複製到mdless
;如果作為mdless
調用,它會自動使用分頁。
運行cargo build --release
。產生的mdcat
可執行檔連結到系統的 SSL 函式庫,即 Linux 上的 openssl。
要建立獨立的可執行文件,請使用cargo build --features=static
;產生的可執行檔使用純 Rust SSL 實作。但它仍然使用系統的 CA 根。
打包mdcat
時,您可能想要包含以下附加工件:
從mdless
到mdcat
的符號連結或硬連結(見上文)。
相關 shell 的 shell 補全,透過在建置後呼叫mdcat --completions
來完成,例如
$ mdcat --completions fish > /usr/share/fish/vendor_completions.d/mdcat.fish
$ mdcat --completions bash > /usr/share/bash-completion/completions/mdcat
$ mdcat --completions zsh > /usr/share/zsh/site-functions/_mdcat
# Same for mdless if you include it
$ mdless --completions fish > /usr/share/fish/vendor_completions.d/mdless.fish
$ mdless --completions bash > /usr/share/bash-completion/completions/mdless
$ mdless --completions zsh > /usr/share/zsh/site-functions/_mdless
使用 AsciiDoctor 建置手冊頁mdcat.1.adoc
:
$ asciidoctor -b manpage -a reproducible -o /usr/share/man/man1/mdcat.1 mdcat.1.adoc
$ gzip /usr/share/man/man1/mdcat.1
# If you include a mdless as above, you may also want to support man mdless
$ ln -s mdcat.1.gz /usr/share/man/man1/mdless.1.gz
mdcat
可以根據要求輸出大量追蹤資訊。使用$MDCAT_LOG=trace
運行mdcat
以獲得完整的追蹤信息,或使用$MDCAT_LOG=mdcat::render=trace
mdcat 僅追蹤渲染。
版權所有塞巴斯蒂安·威斯納 [email protected]
二進位檔案受 Mozilla 公共授權 v. 2.0 條款的約束,請參閱授權。
除非另有說明,大部分原始碼均受 Mozilla 公共授權 v. 2.0 條款的約束,請參閱授權;某些文件受 Apache 2.0 授權條款的約束,請參閱 http://www.apache.org/licenses/LICENSE-2.0