Alternative input formats


Currently, Zola only supports CommonMark.

There have been some requests for Asciidoc and rst.

Adding an input format is a VERY significant amount of work, even assuming there is an existing parser for it in Rust which is a big assumption. Since I don’t personally need it, the implementation would need to come from a contributor.

The goal is not to support every format under the sun as it increases the burden considerably: any addition in the content like the shortcodes need to be replicated n times. Therefore I would prefer to have n <= 2, with my own preference going to Asciidoc for the alternative one.

Any alternative input format needs to support the same feature set as CommonMark:

  • shortcodes
  • automatic header link insertion
  • syntax highlighting
  • link checking
  • relative links
  • summary