Hugo is a popular static site generator written in the Go programming language. Hugo is jam-packed with features, but one of its main selling points is speed — Hugo takes mere seconds to generate a site with thousands of pages. Smashing Magazine recently switched to Hugo from WordPress.

Hugo has excellent Markdown support out of the box. By default, Hugo uses the Goldmark Markdown processor which is fully CommonMark-compliant. See the configuration instructions to learn more about the extensions you can configure. You can change Hugo’s Goldmark settings in the config.toml file, as shown below.

baseURL = "http://mysite.org/"
languageCode = "en-us"
title = "My Site"
theme = "ananke"

[markup]
taskLists = false

Hugo Markdown Support

Hugo provides support for the following Markdown elements using its default Goldmark Markdown processor.

Element Support Notes
Headings Yes
Paragraphs Yes
Line Breaks Yes
Bold Yes
Italic Yes By default, using asterisks and underscores in the middle of a word doesn't work you way expect (e.g., in*middle*here and in_middle_here are rendered literally). You can disable the noIntraEmphasis extension to restore the conventional Markdown functionality.
Blockquotes Yes
Ordered Lists Yes
Unordered Lists Yes
Code Yes
Horizontal Rules Yes
Links Yes
Images Yes
Tables Yes Enabled by default.
Fenced Code Blocks Yes Enabled by default. Syntax highlighting is also supported.
Footnotes Yes Enabled by default.
Heading IDs Yes Enabled by default.
Definition Lists Yes Enabled by default.
Strikethrough Yes Enabled by default.
Task Lists Yes Enabled by default.
Automatic URL Linking Yes Enabled by default.
Disabling Automatic URL Linking Yes
HTML Yes Enabled by default.

Support for Additional Syntax Elements

As an added bonus, Hugo provides support for several obscure elements. These are disabled by default, but you can enable them in the config.toml file.

Element Markdown Rendered Output
Emoji :joy: 😂

See Also

Markdown Guide book cover
Take your Markdown skills to the next level.

Learn everything you need to know about Markdown. The Markdown Guide book includes information on getting started, choosing a Markdown application, using basic and extended syntax, and more.

Get the book
Want to learn more Markdown?

Don't stop now! 😎 Star the GitHub repository and drop in to the Slack chat room. If you liked this and want to receive new Markdown tutorials, enter your email address below. No spam!