reStructuredText cheat sheet

This file contains the syntax for commonly used reST markup. See the reStructuredText style guide for detailed information and conventions.

Also see the Sphinx reStructuredText Primer for more details on reST, and the Canonical Documentation Style Guide for general style conventions.

H2 heading

H3 heading

H4 heading

H5 heading

Inline formatting

• UI element

• code

• file path

• command

• Key

• Italic

• Bold

Code blocks

Start a code block:

code:
  - example: true

# Demonstrate a code block
code:
  - example: true

# Demonstrate a code block
code:
  - example: true

Links

• Canonical website

• Canonical website (defined in reuse/links.txt)

• Link defined at the bottom of the page

• https://canonical.com/

• Links

• Link text

• Reference

• Link text

Navigation

Use the following syntax:

.. toctree::
   :hidden:

   sub-page1
   sub-page2

Lists

1. Step 1

   • Item 1

     • Sub-item

   • Item 2

     1. Sub-step 1

     2. Sub-step 2

2. Step 2

   1. Sub-step 1

      • Item

   2. Sub-step 2

Term 1:

Definition

Term 2:

Definition

Tables

Header 1	Header 2
Cell 1 Second paragraph	Cell 2
Cell 3	Cell 4

Header 1	Header 2
Cell 1 Second paragraph	Cell 2
Cell 3	Cell 4

Header 1	Header 2
Cell 1 Second paragraph	Cell 2
Cell 3	Cell 4

Header 1	Header 2
Cell 1 Second paragraph	Cell 2
Cell 3	Cell 4

Notes

Note

A note.

Tip

A tip.

Important

Important information

Caution

This might damage your hardware!

Images

Figure caption

Reuse

This is included text.

If you want to add further machines after the initial initialisation, you can use the microcloud add command.

To use local storage, each machine requires a local disk. To use distributed storage, at least three additional disks (not only partitions) for use by Ceph are required, and these disks must be on at least three different machines.

Tabs

Tab 1Tab 2

Content Tab 1

Glossary

example term

Definition of the example term.

example term

More useful markup

• Added in version X.Y.

• Line 1

  Line 2

  Line 3

• API

---

Custom extensions

Related links at the top of the page:

:relatedlinks: https://github.com/canonical/lxd-sphinx-extensions, [RTFM](https://www.google.com)
:discourse: 12345

Terms that should not be checked by the spelling checker: PurposelyWrong

A terminal view with input and output:

root@vampyr:~# command

the output

A link to a YouTube video:

▶ Watch on YouTube