hexo-renderer-kramed-essence

1.0.4 • Public • Published

hexo-renderer-kramed-essence

GitHub license npm

This plugin uses kramed-essence but not marked nor kramed as render engine, it is a fork of hexo-renderer-kramed. You need to uninstall hexo-renderer-marked or hexo-renderer-kramed to avoid conflicts.

Why use kramed-essence?

For better the support of mathjax. I've modified the inline math format, like this example below:

`$\sigma$`

But this renderer will only wrap your inline tex and display tex with a <script> tag, to fully enable mathjax, you need to add some js code in your theme, what I did in my theme hexo-theme-paperbox is:

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
    menuSettings: {
      zoom: "None"
    },
    showMathMenu: false,
    jax: ["input/TeX","output/CommonHTML"],
    extensions: ["tex2jax.js"],
    TeX: {
      extensions: ["AMSmath.js","AMSsymbols.js"],
      equationNumbers: {
        autoNumber: "AMS"
      }
    },
    tex2jax: {
      inlineMath: [["\\(", "\\)"]],
      displayMath: [["\\[", "\\]"]]
    }
  });
</script>

<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/mathjax/2.6.1/MathJax.js"></script>

Tips

You can use the following formats for your equations:

inlineMath: `$\sigma$`

displayMath: $$\sigma$$

If you need to contain $ in <code> tag:

` $some code$ `

If you need to contain $$ in your text:

\$\$

Installation

$ npm uninstall hexo-renderer-marked --save
$ npm install hexo-renderer-kramed-essence --save

Options

You can configure this plugin in _config.yml.

kramed:
  gfm: true
  pedantic: false
  sanitize: false
  tables: true
  breaks: true
  smartLists: true
  smartypants: true
  • gfm - Enables GitHub flavored markdown
  • pedantic - Conform to obscure parts of markdown.pl as much as possible. Don't fix any of the original markdown bugs or poor behavior.
  • sanitize - Sanitize the output. Ignore any HTML that has been input.
  • tables - Enable GFM tables. This option requires the gfm option to be true.
  • breaks - Enable GFM line breaks. This option requires the gfm option to be true.
  • smartLists - Use smarter list behavior than the original markdown.
  • smartypants - Use "smart" typograhic punctuation for things like quotes and dashes.

Readme

Keywords

Package Sidebar

Install

npm i hexo-renderer-kramed-essence

Weekly Downloads

5

Version

1.0.4

License

GPL-3.0-or-later

Unpacked Size

43.1 kB

Total Files

7

Last publish

Collaborators

  • sshwy