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