如何在Pelican中激活Pygments实现代码语法高亮

你只需要在pelicanconf.py中添加以下配置即可实现需求，你已经安装的Markdown和Pygments依赖可以直接支持该语法，无需额外安装其他包，虚拟环境下也不需要额外调整：

MARKDOWN = {
    'extension_configs': {
        # 代码高亮扩展配置
        'markdown.extensions.codehilite': {
            'css_class': 'highlight',
            'linenums': False,  # 全局默认关闭行号，适配:::语法的无行号需求
            'guess_lang': False
        },
        # 启用围栏代码块，支持:::语言的声明方式
        'markdown.extensions.fenced_code': {}
    },
    'output_format': 'html5'
}

配置生效后两种语法的表现完全符合你的预期：

• :::python开头的代码块会继承全局默认配置，不显示行号
• #!python开头的代码块会被codehilite扩展自动识别，强制开启行号显示

补充说明：如果当前使用的主题没有内置Pygments高亮样式，你可以执行命令pygmentize -S 样式名 -f html -a .highlight > 你的主题静态目录/css/pygments.css生成自定义样式，常用样式有default、github、monokai等，生成后在主题的head模板中引入该CSS文件即可展示高亮效果。

内容的提问来源于stack exchange，提问作者Alex