Improve Markdown support

[johanjanssens]

Template Filters

Inline partial

To render an inline partial using a different format than the page format use the partial tag, format <ktml:partial:[format]>[...]</ktml:partial:[format]>. Example:

<ktml:partial format="md">
Markdown goes here
</ktml:partial> 

Partial rendering is enabled by default and doesn't need to be added to the page filters.

Table of contents

Generate a table of contents (toc) from a page's HTML headers by adding a ktml:toc tag to the page. By default the TOC will use h1 to h6. The min and max headers can be configured using the min and max attributes. <ktml:toc minx="2" max="4"> will only use the headings 2,3,4.

Dynamic anchors are added to the header tags automatically using anchor.js.

Note: Table of contents filter needs to be enabled by adding the tocfilter to the process:filterslist in the page frontmatter.

Code highlighter

To use the code highlighter either use:

1. The default markdown approach using triple backtics

2. The advanced way using fenced code blocks. This is a feature of PHP Markdown Extra.

3. The html way using <pre><ode class="[language]"></code></pre>. The default language is php

The highlighter is using the Atom One Light style

Note: Code highlighting needs to be enabled by adding the highlight filter to the process:filters list in the page frontmatter.