Skip to content

Latest commit

 

History

History
285 lines (195 loc) · 4.9 KB

doc-cheat-sheet.rst

File metadata and controls

285 lines (195 loc) · 4.9 KB
Raw
orphan

ReStructuredText cheat sheet

This file contains the syntax for commonly used reST markup. Open it in your text editor to quickly copy and paste the markup you need.

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

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

align-center

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

image

Figure caption

Figure caption

Reuse

This is included text.

Tabs

Tab 1

Content Tab 1

Tab 2

Content Tab 2

Glossary

example term

Definition of the example term.

example term

More useful markup

  • X.Y

  • Line 1
    Line 2
    Line 3
  • API (Application Programming Interface)

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 single-line terminal view that separates input from output:

the output

A multi-line version of the same:

input

command 1

output 1 :input: command 2 output 2

A link to a YouTube video: