hexo-renderer-markdown-it-ex

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.

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-markdown-it-ex

npm i hexo-renderer-markdown-it-ex --save

or

yarn add hexo-renderer-markdown-it-ex

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.

markdown:
  render:
    html: false
    xhtmlOut: true
    breaks: true
    linkify: true
    typographer: 
    quotes: '“”‘’'
  plugins:
    - plugin:
        name: markdown-it-toc-and-anchor
        enable: true
        options:
          tocClassName: 'toc'
          anchorClassName: 'anchor'
    - plugin:
        name: markdown-it-multimd-table
        enable: true
        options:
          multiline: true
          rowspan: true
          headerless: true
    - plugin:
        name: ./markdown-it-furigana
        enable: true
        options:
          fallbackParens: "()"

change the default setting for code highlight

# Writing
...
highlight:
  enable: false

default Supported Plugins and Examples

• markdown-it-sub: H~2~0 H₂O

• markdown-it-sup: 29^th^ 29^th

• markdown-it-ins: ++inserted++ inserted

• markdown-it-mark: ==marked== marked

• markdown-it-abbr

• markdown-it-bracketed-spans

• markdown-it-attrs

• markdown-it-deflist

• markdown-it-emoji

• markdown-it-footnote

• markdown-it-task-checkbox

• markdown-it-toc-and-anchor

• markdown-it-container

• markdown-it-multimd-table

• markdown-it-collapsible

• markdown-it-charts

• markdown-it-katex

  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-pangu

• 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

• markdown-it-furigana

  Modified from furigana-markdown-it and markdown-it-ruby

  eg. {可愛い犬|か+わい・い・いぬ}