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

Github Pages中Markdown转HTML时围栏代码块背景不显示求助

Github Pages代码块无灰色背景的解决方法

这不是已知bug,主要是默认主题样式缺失或语法高亮的样式类未正确配置导致的,以下是具体解决步骤:

  • 调整配置文件:
    你的现有配置已经指定了rouge作为语法高亮器,可补充一行配置让代码块生成标准的样式类,修改后的配置如下:

    name: RTcmix
    markdown: GFM
    kramdown:
        syntax_highlighter: rouge
        syntax_highlighter_opts: { css_class: 'highlight' }
        input: GFM
    
  • 添加自定义CSS样式:
    在仓库根目录下创建assets/css/style.css文件(如果使用默认主题结构),添加以下样式代码,给代码块加上灰色背景和适配的排版:

    .highlight {
      background-color: #f6f8fa;
      border-radius: 3px;
      padding: 16px;
      overflow-x: auto;
    }
    .highlight pre {
      margin: 0;
    }
    
  • 主题适配检查:
    若使用Github Pages默认主题(如Minima),部分旧版本对代码块样式支持不完善,可尝试切换至更新的主题,或通过上述自定义CSS的方式补全样式。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.08 05:06:01