hexo-renderer-multi-markdown-it
This renderer plugin uses Markdown-it as a render engine on [Hexo].
This renderer plugin is forked from hexo-renderer-markdown-it and hexo-renderer-markdown-it-plus.
And minify tool is forked from hexo-neat.
Installation
Warning: make sure you're inside the main hexo directory before starting this guide.
A default Hexo installation will include a markdown renderer plugin which uses marked, so you will have to remove it if you want to use this renderer.
npm un hexo-renderer-marked --save
or
yarn remove hexo-renderer-marked
If you have already removed the default renderer, and others you might of added, you can now safely install hexo-renderer-multi-markdown-it
npm i hexo-renderer-multi-markdown-it --save
or
yarn add hexo-renderer-multi-markdown-it
if an error is reported as
ERROR: Failed to download Chromium r515411! Set "PUPPETEER_SKIP_CHROMIUM_DOWNLOAD" env variable to skip download.
please try again with the following command
yarn add hexo-renderer-multi-markdown-it --ignore-scripts
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.
# opitions for renderermarkdown:render:html: falsexhtmlOut: truebreaks: truelinkify: truetypographer:quotes: '“”‘’'plugins:- plugin:name: markdown-it-toc-and-anchorenable: trueoptions:tocClassName: 'toc'anchorClassName: 'anchor'- plugin:name: markdown-it-multimd-tableenable: trueoptions:multiline: truerowspan: trueheaderless: true- plugin:name: ./markdown-it-furiganaenable: trueoptions:fallbackParens: "()"- plugin:name: ./markdown-it-spoilerenable: trueoptions:title: "你知道得太多了"# options for minifyminify:html:enable: trueexclude:- '**/json.ejs'- '**/atom.ejs'- '**/rss.ejs'css:enable: trueexclude:- '**/*.min.css'js:enable: truemangle:toplevel: trueoutput:compress:exclude:- '**/*.min.js'
disable the highlight of site _config.yml
# Writing
...
highlight:
enable: false
prismjs:
enable: false
default Supported Plugins and Examples
-
markdown-it-sub:
H~2~0
H2O -
markdown-it-sup:
29^th^
29th -
markdown-it-ins:
++inserted++
inserted -
markdown-it-mark:
==marked==
marked -
If you want to use katex, you must add this css style to your website:
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/katex@0/dist/katex.min.css">
-
markdown-it-prism
code highlighted by Prism.js
comments will be spaced by
pangu.js
-
marked line
mark:1,3-4
-
command
command:{["[ee@s] $":1-2]["#":5-6,9-10]}
-
-
markdown-it-mermaid
Support for Mermaid
You should add css style for mermaid.
-
markdown-it-graphviz
Based on Graphviz
-
markdown-it-chart
Based on Frappe Charts
-
markdown-it-furigana
Modified from furigana-markdown-it and markdown-it-ruby
eg.
{可愛い犬^か+わい・い・いぬ}
-
markdown-it-spoiler
Modified from markdown-it-spoiler
!!spoiler!!
=><span class="spoiler" title="...">spoiler</span>