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 provides support for the following Markdown elements using its default Goldmark Markdown processor.
|Italic||Yes||By default, using asterisks and underscores in the middle of a word doesn't work you way expect (e.g.,
|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.|
As an added bonus, Hugo provides support for several obscure elements. These are disabled by default, but you can enable them in the
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