Django中Markdown完整代码块高亮正常但行内代码失效的解决方案咨询

核心方案：正确配置pymdownx.inlinehilite扩展 #

你之前尝试pymdownx.inlinehilite失败大概率是配置或用法有误，以下是完整可行的Python端处理方案，无需额外引入JS：

1. 安装依赖 #

确保已安装所需库：

pip install markdown pymdown-extensions pygments

2. 调整Markdown转换配置 #

在Django模型的save方法中，正确配置扩展列表及参数：

from django.db import models
import markdown
from markdown.extensions.codehilite import CodeHiliteExtension
from pymdownx.inlinehilite import InlineHiliteExtension

class Post(models.Model):
    content = models.TextField()
    content_html = models.TextField(blank=True, editable=False)

    def save(self, *args, **kwargs):
        # 配置Markdown扩展
        extensions = [
            'extra',
            'fenced_code',
            CodeHiliteExtension(
                use_pygments=True,
                noclasses=False,  # 生成带CSS类的标签，而非内联样式
                linenums=False
            ),
            InlineHiliteExtension(
                pygments=True,  # 启用Pygments高亮行内代码
                class_prefix='codehilite '  # 与代码块使用相同的CSS前缀，统一样式
            )
        ]
        # 转换Markdown为HTML
        self.content_html = markdown.markdown(
            self.content,
            extensions=extensions
        )
        super().save(*args, **kwargs)

3. 行内代码的正确写法 #

pymdownx.inlinehilite需要在行内代码前指定语言标识，格式为：

`python print("hi")`

转换后会生成带Pygments高亮类的HTML标签，示例：

<span class="codehilite language-python"><code>print("hi")</code></span>

4. 添加高亮CSS样式 #

通过pygmentize -S monokai -f html > pygments.css命令生成对应主题的CSS文件，引入到模板中即可让代码块和行内代码共用统一高亮样式。若需单独调整行内代码样式，可补充：

.codehilite.language-python {
    padding: 2px 4px;
    border-radius: 4px;
    font-size: 0.9em;
}

替代方案：自定义Markdown扩展（无需依赖pymdownx） #

如果不想引入pymdown-extensions，可自定义简单扩展处理行内代码：

import markdown
from markdown.inlinepatterns import Pattern
from pygments import highlight
from pygments.lexers import get_lexer_by_name
from pygments.formatters import HtmlFormatter

class InlineCodeHilitePattern(Pattern):
    # 匹配带语言标识的行内代码：`lang code`
    RE = r'`([a-z0-9]+)\s+(.*?)`'

    def handleMatch(self, m):
        lang = m.group(1)
        code = m.group(2)
        try:
            lexer = get_lexer_by_name(lang)
            formatter = HtmlFormatter(noclasses=False)
            return highlight(code, lexer, formatter)
        except:
            # 语言不支持时返回普通行内代码
            return f'<code>{code}</code>'

class InlineCodeHiliteExtension(markdown.Extension):
    def extendMarkdown(self, md):
        md.inlinePatterns.register(InlineCodeHilitePattern(md), 'inlinecodehilite', 180)

将InlineCodeHiliteExtension()加入到save方法的扩展列表即可，用法与pymdownx方案一致。

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