PieCrust-Hoedown 0.1.0

Hoedown Markdown formatter for PieCrust via Misaka

This plugin for PieCrust lets you use Hoedown Markdown via Misaka for faster Markdown processing. It’s much faster than the default pure Python (but more universal) Markdown formatter that comes by default with PieCrust.

To install the plugin:

pip install piecrust-hoedown

Then enable it in your website configuration:

site:
  plugins: [hoedown]

You can specifically use the Hoedown formatter on a per-page basis by adding format: hoedown in the page’s configuration header, but you might want to just make it the default formatter for the whole website:

site:
  default_format: hoedown
  auto_formats:
    md: hoedown

The Hoedown formatter should be mostly compatible with the default Markdown formatter, in the sense that making it the default formatter as specified above should just work, and would make the website bake faster. However, if you were using Markdown Extensions, there may or may not be any equivalent in Hoedown. In this case, your best bet is to replace markdown with hoedown when declaring the extensions, and see if there’s an error about an extension not existing. For instance:

site:
  default_format: hoedown
hoedown:
  extensions: [fenced_code, footnotes, smarty]

The list of extensions is available on the Misaka documentation. Any extension with a dash can also be written with an underscore.