hexo-renderer-markdown-it 插件 快速配

简介

hexo-renderer-markdown-it 是一款用于 Markdown 解析和渲染的插件。

• 用于替换 Hexo 默认自带的 Markdown 渲染器。
• 提供了更丰富的 Markdown 解析和渲染。

官方描述的主要特征：

• 支持Markdown，GFM和CommonMark
• 广泛的配置
• 比默认渲染器更快（默认：hexo-renderer-marked）
• 标题的安全ID
• 以ID为标题的锚点
• 脚注
• 下标<sub> H₂O.
• 上标<sup> x^2
• 下划线<ins> ++insert++

安装

Hexo 主文件目录下：

1. 卸载 Hexo 默认自带的 Markdown 渲染器
2. 安装 hexo-renderer-markdown-it 插件

npm un hexo-renderer-marked --save
npm i hexo-renderer-markdown-it --save

配置

Hexo 主配置文件 _config.yml 中添加以下配置内容（官方提供的完整配置，没有特殊需要不用再次修改）：

# Markdown-it config
markdown:
  render:
    html: true
    xhtmlOut: false
    breaks: true
    linkify: true
    typographer: true
    quotes: '“”‘’'
  plugins:
    - markdown-it-abbr
    - markdown-it-footnote
    - markdown-it-ins
    - markdown-it-sub
    - markdown-it-sup
  anchors:
    level: 2
    collisionSuffix: 'v'
    permalink: true
    permalinkClass: header-anchor
    permalinkSymbol: ¶

更多参考：
hexo-renderer-markdown-it 插件 详解