如何使用Material MkDocs包高亮JSON代码块的7-31行？

在Material MkDocs中，要高亮JSON代码块的指定行，只需在代码块的语言标识后添加高亮参数即可，具体写法如下：

{
  "name": "example",
  "version": "1.0.0",
  "description": "demo",
  "main": "index.js",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview",
    // ... 省略中间行内容
    "lint": "eslint ."
  },
  "keywords": [],
  "author": "",
  "license": "MIT"
}

关键注意事项 #

• linenos=table：可选参数，用于显示带编号的行号，方便定位；不需要行号的话可以直接去掉，只保留hl_lines="7-31"
• hl_lines="7-31"：核心参数，指定要高亮的行范围；单行高亮写hl_lines="7"，多个不连续行用逗号分隔，比如hl_lines="7,12,15-31"

如果之前尝试未生效，排查以下几点：

• 确保参数紧跟在json标识后，中间不能有空格
• 行号计数从代码块的第一行开始计算（示例中"dev": "vite"是第7行）
• 检查mkdocs.yml配置，Material主题默认已启用代码高亮，无需额外配置

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