Markdown Syntax in Hugo


Headings from h1 through h6 are constructed with a # for each level:

  • # h1 Heading
  • ## h2 Heading
  • ### h3 Heading
  • #### h4 Heading
  • ##### h5 Heading
  • ###### h6 Heading


Horizontal Rules

Horizontal rules are lines that create a nice visual break between sections of your content. In HTML, you use the <hr> tag to create the horizontal rule. In markdown, you use one of the following:

  • ___ three consecutive underscores
  • --- three consecutive dashes
  • *** three consecutive asterisks



Comments can be made in the usual HTML-compatible way:

  • <!--
  • This is a comment
  • -->



When you write a normal paragraph of plain text, such as this paragraph you are reading now, it will be wrapped in

tags when rendered as HTML. In markdown, a new paragraph is created when you put one or more blank lines between them. Line breaks can also be done by adding either a backslash \ or two blank spaces at the end of the line.


Bold, Italics and Strikethrough

  • **rendered as bold text**

  • rendered as bold text

  • _rendered as italicized text_

  • rendered as italicized text

  • ~~Strike through this text.~~

  • Strike through this text.



Blockquotes are great for quoting blocks of text from another source within your article. Simply add a > before the block of text that you wish to quote.



  • * use an asterisk for an unordered list
  • + or you can also use the plus symbol
  • - or a dash/minus character works as well