Converts Markdown files to HTML, with over a dozen builtin themes.

Features

• Includes 15+ ready-made CSS stylesheets for Markdown, see the bottom of the readme for screenshots.
• Reuse the stylesheets or use the generate-md tool to convert a folder of Markdown files to HTML using one of the built-in layouts or a custom layout.
• Completely static output is easy to host anywhere.
• Metadata support: Each file can include additional metadata in a header section, such as the page title and author name which can then be used in the layout.

Layout features

• Built in support for code syntax highlighting via highlight.js; all layouts include a Github-style code highlighting theme by default.
• Built in table of contents generation from Markdown headings, fully customizable by replacing the {{> toc}} partial in custom layout.
• Built in header id and anchor generation for headings written in Markdown; all layouts support revealing the URL via header hover links.
• Support for custom logic for rendering code blocks via --highlight-*; this can be used to implement custom blocks that render the content of the code block in some interesting way.
• Automatically detects the document title from the first heading in the Markdown markup.

• Create your own layout based on an existing layout via --layout with:

  • Full Handlebars support for layouts, helpers and partials
  • Fully customizable table of contents template via the toc partial
  • Support for relative path generation via the {{asset 'path'}} helper