hugo/docs/content/content/supported-formats.md
Baptiste Mathus 7a681035ce Doc for other supported formats (external helpers)
As Hugo now supports more formats thanks to the new "external helpers"
feature recently introduced, and as requested by some people, I added
some lines in the doc:
* basically confirming it actually exists
* how to use it
2015-08-07 22:55:03 -06:00

1.1 KiB

aliases date menu next prev title weight toc
/doc/supported-formats/
2015-08-01
main
parent
content
/content/front-matter /content/organization Supported Formats 15 true

Since 0.14, Hugo has defined a new concept called external helpers. It means that you can write your content using Asciidoc[tor], or reStructuredText. If you have files with associated extensions (details), then Hugo will call external commands to generate the content.

This means that you will have to install the associated tool on your machine to be able to use those formats.

For example, for Asciidoc files, Hugo will try to call asciidoctor or asciidoc command.

To use those formats, just use the standard extension and the front matter exactly as you would do with natively supported .md files.

Notes:

  • as these are external commands, generation performance for that content will heavily depend on the performance of those external tools.
  • this feature is still in early stage, hence feedback is even more welcome.