hexo-renderer-markdown
Markdown-it renderer plugin for Hexo.
Last updated 2 months ago by niemingzhao .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install hexo-renderer-markdown 
SYNC missed versions from official npm registry.

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

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
  1. 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.

Current Tags

  • 1.3.0                                ...           latest (2 months ago)

4 Versions

  • 1.3.0                                ...           2 months ago
  • 1.2.0                                ...           a year ago
  • 1.1.1                                ...           2 years ago
  • 1.0.0                                ...           3 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 2
Dev Dependencies (0)
None
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |