A faster and CommonMark compliant alternative for Hexo.
npm install @upupming/hexo-renderer-markdown-it-plusmarkdown-it plugin.
H~2~0 H20
x^2^ x2
++Inserted++ Inserted, ~~Del~~ @[toc]
shell
npm un hexo-renderer-marked --save
npm i @upupming/hexo-renderer-markdown-it-plus --save
`
Options
Configuring the renderer is a fairly simple task because all the settings are in the main hexo _config.yml file. You just need to open it in your favourite text editor and write down your configuration.
`yml
markdown_it_plus:
highlight: true
html: true
xhtmlOut: true
breaks: true
langPrefix:
linkify: true
typographer:
quotes: “”‘’
pre_class: highlight
`
Katex
Katex plugin is enabled by default. However, this renderer alone does not work out of the box for mathematical formulas to display correctly on your website. Therefore, you do not need to do anything if you do not want to use Katex. Otherwise, if you want to use katex, you must add this css style to your website:
https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.9.0/katex.min.css
Advanced Options
The markdown-it plugins listed above is enabled by default. If you want to disable any plugin, see the configuration example below:
`yml
markdown_it_plus:
highlight: true
html: true
xhtmlOut: true
breaks: true
langPrefix:
linkify: true
typographer:
quotes: “”‘’
plugins:
- plugin:
name: markdown-it-mark
enable: false
`
plugins enabled by default:
+ markdown-it-emoji
+ markdown-it-sub
+ markdown-it-sup
+ markdown-it-deflist
+ markdown-it-abbr
+ markdown-it-footnote
+ markdown-it-ins
+ markdown-it-mark
+ @neilsustc/markdown-it-katex
+ markdown-it-toc-and-anchor
Add other
markdown-it Plugins
If you want to add a plugin named as markdown-it-something:
1.Install this plugin
`javascript
npm install markdown-it-something --save
`
2.config main hexo _config.yml
`yml
markdown_it_plus:
# ...
plugins:
- plugin:
name: markdown-it-something
enable: true
options:
# this is plugin option
`
LOG
+ 1.0.1 Add pre_class option.
+ 1.0.2 Add highlight.js pakage to dependencies#2.
+ 1.0.3 Update katex plugin, using katex 0.9
+ 1.0.4 PR #17
+ 2.0.0 Switch to @neilsustc/markdown-it-katex` for latest KaTeX features. We will keep up-to-date with KaTeX's newest features in the future.