You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Quarto浅色/深色模式自定义语法高亮配置失效求助

在Quarto中为浅色/深色模式设置不同代码高亮的正确方法

针对你遇到的配置后代码高亮消失的问题,核心原因在于高亮风格名称拼写错误和配置层级的细节把控,以下是具体解决步骤:

1. 确认正确的配置结构

需将highlight-style嵌套在format.html层级下(对应你尝试的第二种配置结构),这是Quarto HTML输出专属配置的正确层级。

2. 检查内置高亮风格的正确名称

之前配置中使用的atom-one并非Quarto内置支持的高亮风格名称,这会导致渲染时无法加载对应样式,最终高亮失效。你可以通过终端命令查看所有内置支持的高亮风格:

quarto preview --list-highlight-styles

常见适配的浅色/深色风格组合比如:github(浅色)+github-dark(深色)、atom-one-light(浅色)+atom-one-dark(深色)等。

3. 可正常生效的示例配置

以github作为浅色风格、atom-one-dark作为深色风格为例,正确配置如下:

---
title: "Example"
format:
    html:
        theme:
            light: flatly
            dark: darkly
        highlight-style:
            light: github
            dark: atom-one-dark
eval: false
---

```{r}
# Trivial code
library(tidyverse)

mtcars <- mtcars |>
    group_by(mpg) |>
    distinct() |>
    ungroup() |>
    mutate(id = row_number())
## 4. 验证与排查
渲染文档后切换系统的浅色/深色模式,代码块会自动匹配对应高亮风格。若仍有问题,可尝试清除缓存后重新渲染:
```bash
quarto render your-document.qmd --clean

内容的提问来源于stack exchange,提问作者mfg3z0

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.30 15:13:24