简介
hexo-renderer-markdown-it
是一款用于 Markdown 解析和渲染的插件。
- 用于替换 Hexo 默认自带的 Markdown 渲染器。
- 提供了更丰富的 Markdown 解析和渲染。
官方描述的主要特征:
- 支持Markdown,GFM和CommonMark
- 广泛的配置
- 比默认渲染器更快(默认:hexo-renderer-marked)
- 标题的安全ID
- 以ID为标题的锚点
- 脚注
- 下标<sub> H2O.
- 上标<sup> x^2
- 下划线<ins> ++insert++
安装
Hexo 主文件目录下:
- 卸载 Hexo 默认自带的 Markdown 渲染器
- 安装
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: ¶