Content Styling

Use hashes (#) to designate a section of content:

# Level 1
## Level 2
### Level 3

On this website, the title of the article is designated as a level 1 heading. The rest of the content should be organized with level 2 and greater headings. This allows the article navigation sidebar to populate with links to the different sections of your article.

• Italics: *text*
• Bold: **text**
• Preformatted/Code: `text`

You can also use standard HTML tags to transform text:

• Marked/Highlighted: <mark>text</mark>
• Insert/Underlined: <ins>text</ins>
• Subscripted: <sub>text</sub>
• Superscripted: <sup>TM</sup>
• Deleted/Strikethrough: <del>text</del>

Linking to a site that is outside docs.truenas.com is done with square brackets and parentheses:

[example link text](www.example.com)

You can also link directly just by typing the URL with no additional markup: www.example.com HTML linking syntax is also allowed: <a href="www.example.com">Example Site</a>

To link to another section of the same article, use an anchor (#) to refer to that section header. The header title needs to be in lower case and spaces replaced with dashes (-): [Escape Characters](#escape-characters)

Lists can be ordered or unordered:

1. First
2. Second
3. Third

* Who
* What
* When

A backtick (`) starts or stops an inline code-block: Enter ls to list directory contents. Using three ` backticks on a line starts or stops a multi-line block:

This is a multi-line code block.
foo
bar
baz

Use the right carat (>) to designate a block quote:

> The entire paragraph is formatted as the quote.
>
> You can use a > for every line of the quote or at the beginning of each paragraph of text.

Internal references use the Hugo ref shortcode to look up a file by name:

[Creating a new ZFS Pool]({{\< ref "pools.md" >}})
(remove the escaping backslash \)

Linking to the index file of an article bundle requires using the generic linking syntax to point to the article location:

You can copy the [article template](/contributing/documentation/template/).

You can also use an anchor to link to a specific section within an article:

[Section Level 3]({{\< ref "example.md#section-level-3" >}})
(remove the escaping backslash \)

To add an image to your article, you need to add the image file to your article bundle. Then use the trueimage shortcode in your article to link to the image and define any additional parameters:

{{\< trueimage src="path/to/image.png" alt="Example Image" id="Example Image" >}}
(remove the escaping backslash \)

You can also use HTML to link to an image file that is relative to the site /static/ directory:

<img src="/images/network-interfaces.png" width='700px'>

A simple note box is created with the hint shortcode:

{{\< hint info >}}
This is a simple note box that has a gray background and blue border
{{\< /hint >}}
(remove the escaping backslash \)

Alert boxes can be given any title and use info and warning to define the color:

{{\< hint warning>}}
This is an alert that is titled Warning and uses a red coloration.
{{\< /hint >}}
(remove the escaping backslash \)

You can call either the Font Awesome or Material Design graphical fonts in your text to be more precise about what buttons or icons to click in the TrueNAS web interface. Below are examples of icons that are already being used on the Docs website, along with the exact code you would add to the Markdown file to call that icon.

To find icons that you can include with your text, please refer to the Material Design or Font Awesome Icon Libraries. Note that only the Free and Solid Font Awesome icons are supported.

To improve accessibility assistance, please be sure to use the aria-hidden and title fields with your icon. This allows users that require accessibility assistance like screen readers to be able to know what icon is being used.