Markdown Guide

This topic provides additional Markdown usage guidelines and more detail about selected Markdown editing capabilities already covered in the Make a Larger Contribution topic.

Inline Styling

Double tildas (~) can be used to display text with a line through it.

For example, this Markdown will output the following text:

~~This text will have a strikethrough style~~

This text will have a strikethrough

Links and References

There are multiple types of links and references that can be added to Markdown files built with Hugo. Each has an equivalent inline Markdown. All links and references are rendered as green text.

External Link

This type of link is used to reference content outside of the documentation site, typically to another website.

In-page Anchor

This type of link is used to reference content in another section within the same file.

Image References

In general, Cumulus uses the img and figure shortcodes to reference static images; however, you can also use inline Markdown.


Note that the reference text is not displayed.

For example, this Markdown renders the following images:

![Trace Request Small]

Tables

Creating tables in Markdown is very easy. Use three or more hyphens (—) to create each column header and pipes (|) to separate each column. While optional, Cumulus uses pipes on either end of a table row as well.

For example, this Markdown renders the following table:

Align Content

Colons can be used to align column content.

For example, this Markdown renders the following table:

Use Inline Styles

You can also use inline Markdown to format your text if needed.

For example, this Markdown renders the following table: