Typography

Use a mix of Markdown and HTML syntax to style your content.

Hinode uses a mix of basic Markdown syntax enriched with Bootstrap styling for the typography. The following paragraphs illustrate the most common applications. Refer to the Hugo documentation to review the extended description of supported content formats  . It also contains links to external resource about Markdown.

Headings  

Use the native Markdown character # to generate headings for your content. The following input represents six levels of section headings. They are generated as HTML <h1>—<h6> elements. <h1> is the highest section level while <h6> is the lowest.

# H1. Heading

## H2. Heading

### H3. Heading

#### H4. Heading

##### H5. Heading

###### H6. Heading

Alternatively, you can use .h1 through .h6 classes, for when you want to match the font styling of a heading but cannot use the associated HTML element. For example, using a .h2 class will exclude the section heading from the generated table of contents.

H1
{.h1}

H2
{.h2}

H3
{.h3}

H4
{.h4}

H5
{.h5}

H6
{.h6}

Display headings  

Display a larger, slightly more opinionated heading style by adding the .display class.

Display 1
{.display-1}

Display 2
{.display-2}

Display 3
{.display-3}

Display 4
{.display-4}

Display 5
{.display-5}

Display 6
{.display-6}

Lead  

Make a paragraph stand out by adding the .lead class.

This is a lead paragraph. It stands out from regular paragraphs.
{.lead}

Inline text elements  

You can use native Markdown to apply basic styling. Use HTML elements for additional formatting options.

Native Markdown  

Use native Markdown apply basic styling to your text.

~~This line of text is meant to be treated as deleted text.~~

_This line of text renders as underlined._

**This line of text renders as bold text.**

*This line of text renders as italicized text.*

Extended Styling  

Use shortcodes and classes for additional styling options. The following example illustrates highlighting, fine print, subscript, and superscript.

You can use the mark shortcode to {{< mark >}}highlight{{< /mark >}} text.

This line of text is meant to be treated as fine print.
{.small}

H{{< sub 2 >}}O is a liquid.

2{{< sup 10 >}} is 1024.

Emoji  

Use shortcodes to insert Emoji into your content. You can use this list of emoji  shortcodes as a reference, although the results may vary across browsers and devices. The following example inserts an inline smiley.

That is so funny! :smiley: That is so funny! :smiley:

The result looks like this:

Abbreviations  

Use the abbr shortcode for abbreviations and acronyms to show the expanded version on hover. Abbreviations have a default underline and gain a help cursor to provide additional context on hover and to users of assistive technologies.

{{< abbr HTML >}}

Blockquotes  

The blockquote element represents content that is quoted from another source, optionally with a citation which must be within a footer or cite element, and optionally with in-line changes such as annotations and abbreviations. Use the > Markdown character to generate a blockquote and add {.blockquote} at the bottom of the block to apply the correct styling.

Blockquote without attribution  

The following Markdown generates a blockquote without attribution.

> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
> **Note** that you can use _Markdown syntax_ within a blockquote.
{.blockquote}

Blockquote with attribution  

The following Markdown generates a blockquote with attribution. The citation itself is added to the bottom of the page.

> Don't communicate by sharing memory, share memory by communicating.
>
> — *Rob Pike[^1]*
{.blockquote}

[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) during Gopherfest, November 18, 2015.

Code Blocks  

Use a single backtick ` character to denote an inline code element. Use triple backticks ``` to denote the start and end of a code block. Add the language to the opening backticks to specify the syntax. Hugo uses Chroma highlighting to style the syntax of supported languages  . The following example defines an HTML code block.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Example HTML5 Document</title>
  </head>
  <body>
    <p>Test</p>
  </body>
</html>

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Example HTML5 Document</title>
  </head>
  <body>
    <p>Test</p>
  </body>
</html>
```

List Types  

Use native Markdown to define ordered lists, unordered lists, and nested lists.

Ordered List  

The following Markdown defines an ordered list of three items. The sequence is automatically determined, so simply add 1. at the start of each element. The linting rules will raise an error if you add the sequence numbering yourself.

1. First item
1. Second item
1. Third item

Unordered List  

Use the - character to denote an unordered list.

- List item
- Another item
- And another item

Nested list  

Use indendation and the - character to denote a nested list.

- Fruit
  - Apple
  - Orange
  - Banana
- Dairy
  - Milk
  - Cheese

Task list  

Use the - character followed by either [x] or [ ] to indicate a (completed) task.

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

Mathemetical formulas  

Use KaTeX  to add mathemetical formulas to your content pages. By default, the support for KaTeX is optional. Be sure to include katex in your module configuration and page frontmatter as needed.

This is an inline $-b \pm \sqrt{b^2 - 4ac} \over 2a$ formula

This is not an inline formula:

$$x = a_0 + \frac{1}{a_1 + \frac{1}{a_2 + \frac{1}{a_3 + a_4}}}$$  
$$\forall x \in X, \quad \exists y \leq \epsilon$$