4.1. Markdown support

In addition to HTML, an ebook page may be written in Markdown. However for this to work, the file extension of the page written in Markdown must be md, markdown, mdown, mkdn, mdwn, mkd, rmd, text or txt.

Out of the box, the Markdown parser is configured to support the commonmark 0.28 “Markdown dialect” plus the following extensions:

This configuration corresponds to what’s described in the Markdown Cheatsheet.

However, thanks to the flexmark-java software component used by ebookc to implement Markdown support, all this can be configured by passing some load.markdown.XXX options to ebookc.

For example, simply pass -p load.markdown.more-extensions true to ebookc in order to add the following Markdown syntax extensions:

Supported Markdown syntax extensions are documented in Section 4.1.1. Supported Markdown extensions.

Other example, pass

to ebookc in order to parse the Github-flavored Markdown dialect and to enable task lists syntax extension.

Supported “Markdown dialects” are COMMONMARK, COMMONMARK_0_26, COMMONMARK_0_27, COMMONMARK_0_28, FIXED_INDENT, KRAMDOWN, MARKDOWN, GITHUB_DOC, GITHUB, MULTI_MARKDOWN, PEGDOWN, PEGDOWN_STRICT. See Markdown Processor Emulation.