如何实现代码的高亮功能

在GitBook生成的静态文档中,默认的代码样式没有高亮,不够醒目。这是由于在书写md时,没有指定代码语言。指定特定语言后,即可实现高亮:

  1. <p>test</p>

上述效果的代码如下:

  1. ```html
  2. <p>test</p>
  3. ```

highlight插件支持的语法

gitbook-plugin-highlight 使用 highlight.js 作为后台渲染引擎,highlight.js 支持的语言及简写可在官方手册中查看。

使用prism插件

系统自带插件的高亮功能并不完善,可使用prism插件增强,该插件需要先禁用highlight插件。

在配置文件中增加如下信息:

  1. {
  2. "plugins": ["-highlight", "prism", "prism-themes"]
  3. }
  4. "pluginsConfig": {
  5. "prism": {
  6. "css": [
  7. "prismjs/themes/prism-solarizedlight.css"
  8. ]
  9. }
  10. }

使用prism高亮插件的优点在于,可以使用不同的配色方案,且语法关键词识别度比highlight插件高。prism支持的语言可在其官方网站查询。