This article offers a sample of basic Markdown syntax that can be used in Hugo content files. Also, it shows whether key HTML elements are decorated with CSS in a Hugo theme.
Note: this was written by the Hugo maintainers, not myself. I included it here to illustrate features of the theme. Some grammatical changes were made as needed.
Headings
The following HTML <h2>
—<h6>
elements represent five levels of section headings. <h2>
is the highest section level recommended for use in Markdown, while <h6>
is the lowest. <h1>
should be reserved for the page title.
H2
H3
H4
H5
H6
Paragraph
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus porttitor non nisi eu molestie. In mi orci, imperdiet a massa et, imperdiet tincidunt turpis. Proin in varius diam. Aliquam erat volutpat. Vestibulum in aliquet odio. Aenean sodales sapien id nisi finibus, scelerisque luctus mauris dictum. Vestibulum ornare sem mi, ut malesuada ipsum faucibus vel.
Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.
Blockquotes
The blockquote element represents content quoted from another source, with an optional citation within a <footer>
or <cite>
and optional inline changes such as annotations and abbreviations.
Blockquote without attribution
Tiam, ad mint andaepu dandae nostion secatur sequo quae. Note that you can use Markdown syntax within a blockquote.
Blockquote with attribution
Don’t communicate by sharing memory, share memory by communicating.
— Rob Pike1
Tables
Tables aren’t part of the core Markdown spec, but Hugo supports them out of the box.
Name | Age |
---|---|
Bob | 27 |
Alice | 23 |
Inline Markdown within tables
Italics | Bold | Code |
---|---|---|
italics | bold | code |
Code Blocks
Code block with backticks
html 1<!doctype html>
2<html lang="en">
3<head>
4 <meta charset="utf-8">
5 <title>Example HTML5 Document</title>
6</head>
7<body>
8 <p>Test</p>
9</body>
10</html>
Code block indented with four spaces (no highlighting)
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Example HTML5 Document</title>
</head>
<body>
<p>Test</p>
</body>
</html>
Code block with Hugo’s internal highlight shortcode
1<!doctype html>
2<html lang="en">
3<head>
4 <meta charset="utf-8">
5 <title>Example HTML5 Document</title>
6</head>
7<body>
8 <p>Test</p>
9</body>
10</html>
List Types
Ordered List
- First item
- Second item
- Third item
Unordered List
- List item
- Another item
- And another item
Nested list
- Fruit
- Apple
- Orange
- Banana
- Dairy
- Milk
- Cheese
Other Elements — abbr, sub, sup, kbd, mark
GIF is a bitmap image format.
H2O
Xn + Yn = Zn
Press CTRL+ALT+Delete to end the session.
Most salamanders are nocturnal and hunt for insects, worms, and other small creatures.