2026年5月7日
MarkText使用highlight.js作为代码高亮引擎,支持超过180种编程语言的语法高亮。常用语言包括:Python、JavaScript、TypeScript、Java、C、C++、Go、Rust、SQL、Bash、HTML、CSS、JSON、YAML、Markdown本身等。每种语言都有对应的语言标识符,如python、javascript、java等,在代码块中指定语言名称即可获得对应的高亮效果。
创建代码块的语法是三个反引号开头,接着指定语言名称,然后输入代码内容,最后用三个反引号结束。例如:```python后跟Python代码,```javascript后跟JavaScript代码。代码块内可以使用Tab键缩进,支持多行代码,高亮效果自动应用。代码块的背景色和字体由当前主题决定,可以在主题设置中自定义。
MarkText的代码块支持多种高级功能:复制代码按钮悬停在代码块右上角会出现;代码块内支持行号显示;支持语法错误检测;支持代码折叠。右键代码块可以查看更多选项,如复制代码、调整缩进、选择语言等。
技术写作中经常需要展示代码示例。好的代码示例应该:包含必要的注释说明、使用清晰的变量命名、分段展示复杂逻辑。以Python为例,好的示例应该加上#号注释说明每段代码的作用,并在注释中标注关键知识点,让读者能快速理解代码意图。
每种编程语言都有其特殊语法需要注意:Python依赖缩进,代码块中缩进必须正确;JavaScript有分号与无分号的风格差异;正则表达式需要双反斜杠转义。MarkText的代码高亮能正确处理这些特殊语法,渲染效果与语法规范一致。
在MarkText的主题设置中,可以自定义代码块的样式:背景色、字体、字号、行号颜色、关键字颜色等。对于技术博客,建议选择一个代码背景色与主题背景色对比明显的主题,确保代码块在文章中醒目突出。
代码高亮是技术写作的核心技能之一。MarkText对代码块的支持非常完善,180多种语言的语法高亮覆盖了绝大多数技术写作场景。掌握正确的代码块使用技巧,可以让你的技术文档专业度大幅提升。
开启优雅写作之旅
sudo snap install marktext (Linux)