如何在Confluence的Markdown代码中启用语法高亮
Confluence Markdown 代码块语法高亮配置指南
内置Markdown引擎的高亮开关开启步骤
- 进入Confluence全局管理后台,找到内置的「Markdown Renderer」插件配置页
- 定位到「fenced code blocks 语法高亮」选项,将其调整为开启状态。该选项在Confluence 7.0到8.5的多数版本中默认关闭,是导致Markdown编写的代码无高亮的核心原因
- 保存配置后全局生效,如果修改后页面仍无高亮效果,清理浏览器本地缓存后重新进入页面即可
Markdown代码块的合规书写要求
开启引擎开关后,写法不规范依然会导致高亮失效:
- 三反引号包裹的代码块,必须在开头的反引号后紧跟明确的语言标识,比如
```java、```sql,没有标注语言的代码块会被直接按纯文本渲染 - 不要将代码块嵌套在列表、引用块的多层缩进结构中,Confluence的内置解析器对嵌套场景下的代码块识别存在兼容问题,会直接跳过高亮渲染流程
- 代码块内部不要混入未转义的Markdown格式标记,避免触发解析器的格式混淆
第三方扩展Markdown插件的兜底配置
如果使用的是从应用市场安装的扩展类Markdown插件:
- 进入插件配置页,将代码块的渲染引擎切换为和Confluence原生代码块一致的PrismJS渲染组件,不要使用插件自带的纯文本渲染模式
- 确认插件加载的高亮语言包覆盖日常使用的开发语言,缺失对应语言包时,即使标注了正确的语言标识,也不会输出高亮效果
内容的提问来源于stack exchange,提问作者Enlico
相关产品推荐
相关产品推荐

