hexo-renderer-markdown

This renderer plugin is inspired by hexo-renderer-markdown-it. It uses Markdown-it as a render engine on Hexo with more markdown-it plugins.

Main Features

• Support for Markdown
• Extensive Configuration
• Faster than the default renderer | hexo-renderer-marked
• abbr
• anchor
• attrs
• checkbox
• deflist
• emoji
• footnote
• ins
• katex
• mark
• sub
• sup

Installation

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

Configuration

If you want to change some settings, you can add the config to the main hexo _config.yml file.

markdown:
  render:
    html: true
    xhtmlOut: false
    breaks: true
    linkify: true
    typographer: true
    quotes: “”‘’
  plugins:
    markdown-it-anchor:
      level: 1
      slugify: function (s) {return encodeURIComponent(s);} # String starting with 'function' will be parsed as a function that satisfies the plugin
      permalink: true
      permalinkClass: header-anchor
      permalinkSymbol: ¶
      permalinkBefore: true
    markdown-it-checkbox:
      divWrap: false
      divClass: checkbox
      idPrefix: checkbox
    markdown-it-katex:
      throwOnError: false
      errorColor: "#cc0000"
      csslink: https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.6.0/katex.min.css # KaTeX plugin needs the CSS file link

Disable markdown-it Plugins

Now you can disable the default plugins with giving them the setting disabled: true.

Add markdown-it Plugins

If you want to add a new markdown-it-something plugin, it's fairly simple.

1. Install the plugin

npm i markdown-it-something --save

2. Config the _config.yml

markdown:
  # ...
  plugins:
    markdown-it-something:
      option_example: value_example
      _parser: parser.use(require(pugs), pugs_opt) # This describes how to load the plugin because some plugins have nonstandard load style. The string will be 'eval' to execute. 'parser' - the markdown-it parser instance, 'pugs' - the plugin name, 'pugs_opt' - the plugin options.

Bug Reports

If you have any bugs to report, you're welcome to file an issue.