hexo-renderer-markdown-it-plus 插件介绍

hexo-renderer-markdown-it-plus 插件介绍

总述

插件 Github 地址
这个渲染器插件使用 Markdown-it 作为 Hexo 上的渲染引擎。
这个渲染器插件是从 hexo-renderer-markdown-it 派生而来的。
添加一些插件并支持第三方 markdown-it 插件。
这是一个 演示项目.

主要特点

• 支持 Markdown 语法
• 拥有广泛的配置
• 比默认渲染器(hexo-renderer-marked)更快
• sub, H~2~0 H₂0
• sup, x^2^ x²
• ins, ++Inserted++ Inserted, ~~Del~~ Del
• Katex, referer
• emoji, referer
• toc&anchor @[toc]
• deflist
• abbr
• footnote
• mark

安装

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

配置

配置渲染器是一项相当简单的任务，因为所有设置都在主 Hexo 配置文件 _config.yml 中。你只需要在你最喜欢的文本编辑器中打开它，并写下你的配置。

markdown_it_plus:
    highlight: true
    html: true
    xhtmlOut: true
    breaks: true
    langPrefix:
    linkify: true
    typographer:
    quotes: “”‘’
    pre_class: highlight

Katex

默认情况下启用Katex插件。然而，仅此渲染器并不能开箱即用，使数学公式在您的网站上正确显示。因此，如果您不想使用Katex，则无需执行任何操作。否则，如果你想使用katex，你必须将这个css样式添加到你的网站：
https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.9.0/katex.min.css

高级配置

上面列出的 markdown-it 插件是默认启用的。如果您想禁用任何插件，请参阅下面的配置示例：

markdown_it_plus:
    highlight: true
    html: true
    xhtmlOut: true
    breaks: true
    langPrefix:
    linkify: true
    typographer:
    quotes: “”‘’
    plugins:
        - plugin:
            name: markdown-it-mark
            enable: false

默认启用的插件：

• markdown-it-emoji
• markdown-it-sub
• markdown-it-sup
• markdown-it-deflist
• markdown-it-abbr
• markdown-it-footnote
• markdown-it-ins
• markdown-it-mark
• @iktakahiro/markdown-it-katex
• markdown-it-toc-and-anchor

添加其他 markdown-it 插件

如果你想添加一个名为 markdown-it-something 的插件:

1.安装这个插件

npm install markdown-it-something --save

2.配置主 Hexo 配置文件 _config.yml

markdown_it_plus:
    # ...
    plugins:
        - plugin:
            name: markdown-it-something
            enable: true
            options:
                # this is plugin option