2020-September-15 Hugo v0.75.1 released. To keep up with Hugo releases, see discourse.gohugo.io/c/announcements, github.com/gohugoio/hugo/releases, gohugo.io/news, old.reddit.com/r/gohugo/, or mobile.twitter.com/@GoHugoIO.
2020-July-13 Hugo v0.74.0 released with “reworked external Asciidoctor integration.” To learn about this, see the v0.74.0 release notes, github.com/gohugoio/hugo/pull/7281, and gohugo.io/content-management/formats/. Thank you @muenchhausen (Derk Muenchhausen), @bwklein (Bryan Klein), and all Hugo contributors!👏
Hugo versions 0.60.0 and later include support for the following markup languages.
To use one of
the last three markup languages,
need to install an external
Hugo determines the markup language of a content file that has one of the above 13 file extensions from…
markup key-value pair in the file’s front matter
the file’s file extension.
The first of these found wins. This means that you can override the default meaning of a file extension by putting the following in the YAML front matter of a content file.
Possible markup identifiers are in the first column of the table above. For example, you could use one of the following.
markup: markdown markup: mmark markup: org markup: html markup: asciidoc markup: pandoc markup: rst markup: goldmark # v0.60.0+ markup: blackfriday # v0.60.0+ markup: asciidocext # v0.74.0+
markup: defaultMarkdownHandler: blackfriday
In Hugo v0.59.1 and earlier…
To learn more about Hugo’s support for markup languages, see the following.
“ox-hugo is an Org exporter backend that exports Org to Hugo-compatible Markdown and also generates the front-matter (in TOML or YAML format).”
If you install…
you can create
R Markdown (
.Rmd) files that
blogdown — along with
hugo — will render
blogdown package installs and
For more about this, see:
For more gohugo-related links, see Infinite Ink’s #gohugo Portal.
.mkd. This way you and your text editor will interpret it as a Markdown file, but Hugo won’t. I do this with backup and other Markdown files that I do not want Hugo to process. For a discussion about this, see Avoid rendering of specific .md files from blogdown::serve_site() at stackoverflow.com.
go-org. Hugo versions 0.55.6 and earlier use
goorgeous. Discussion about this in this issue.
.ad,Asciidoctor also recognizes
.txtas a file extension of an AsciiDoc file. This is useful if you want to hide the AsciiDocness of a content file, for example an include file, from Hugo.
content/directory, a file with one of the following file extensions will be interpreted by
hugoas containing a known markup language: