Markdown

5 min read

This page gives an overview of different markdown elements and how they fit together. Custom React components embedded in the markdown can also support markdown syntax, as long as there are empty lines between the component tag and the content.

A section header
Clipboard icon

A beta section BETA
Clipboard icon

The <Beta /> tag can be used inline BETA and should be applied self-closing

Paragraphs
Clipboard icon

Paragraphs are separated by a blank line.

Second paragraph. Italic, bold, italic bold, strikethrough, and monospace.

Line Break
Clipboard icon

The backslash, \, is interpreted as a new line.
This sentence should appear on a new line.

List items
Clipboard icon

Itemized lists look like:

  • this one
  • that one
  • the other one

Note that --- not considering the asterisk --- the actual text content starts at 4-columns in.

Blockquotes
Clipboard icon

Block quotes are written like so.

They can span multiple paragraphs, if you like.

Blockquotes can be nested (that is a blockquote-in-a-blockquote) by adding additional levels of >:

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

Blockquotes can contain other Markdown elements, including headers, lists, and code blocks:

This is a header.
Clipboard icon

  1. This is the first list item.
  2. This is the second list item.

Here's some example code:

return shell_exec("echo $input | $markdown_script");
Clipboard icon

Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all in chapters 12--14"). Three dots ... are converted to an ellipsis. Unicode is supported. ☺

Subsection (first level)
Clipboard icon

Lists
Clipboard icon

Here's a numbered list:

  1. first item
  2. second item
  3. third item

Here's a nested ordered list:

  1. Step 1
    1. Sub-step 1
    2. Sub-step 2
      1. Sub Sub-step 1
      2. Sub Sub-step 2
  2. Step 2

Here's a definition list:

Healthy

The subscription is delivering messages as expected

ConfigurationError

Messages can not be delivered with the current configuration. If the configuration is fixed in this health status, all messages that haven’t been delivered yet will still be delivered and the status will change to Healthy.

ConfigurationErrors are automatically turned into ConfigurationErrorDeliveryStopped after some time. See the Delivery Guarantees section for more details.

ConfigurationErrorDeliveryStopped

Messages can not be delivered with the current configuration and delivery of those is not attempted anymore. Undelivered messages are not retained and will not be delivered if the configuration is fixed in this status, but the status will change to Healthy as soon as new messages can be delivered successfully again.

Something else
Yet something else

Subsection (second level)
Clipboard icon

Now a nested list:

  1. First, get these ingredients:

    • carrots
    • celery
    • lentils
  2. Boil some water.

  3. Dump everything in the pot and follow this algorithm:

    find wooden spoon
    uncover pot
    stir
    cover pot
    balance wooden spoon precariously on pot handle
    wait 10 minutes
    goto first step (or shut off burner when done)
    Clipboard icon

    Do not bump wooden spoon or it falls.

Notice again how text always lines up on 4-space indents (including that last line which continues item 3).

Code blocks
Clipboard icon

Note again how the actual text starts at 4 columns in (4 characters from the left side). Here's a code sample:

# Let me re-iterate ...
for i in 1 .. 10 { do-something(i) }
Clipboard icon

As you probably guessed, indented 4 spaces. By the way, instead of indenting the block, you can use delimited blocks, where you can specify syntax highlight (highly recommended):

const sum = (a, b) => a + b;
console.log(sum(5, 2));
Clipboard icon

Empty code blocks also work without breaking the build:

Clipboard icon

Tables
Clipboard icon

Tables look like this:

Left AlignedExternal link iconCenter AlignedRight Aligned
Helloshort$1600
Worldcontent$12
zebra stripesavoid insects$1

Horizontal rules
Clipboard icon

Horizontal rules are not styled.


Constants
Clipboard icon

  • Number and text example -> 64 megabytes
  • Number example in bold -> 256
  • Text example -> [a-zA-Z0-9_\-]{2,256}
  • Long formatted number example -> 1 000 000.999999

Last section
Clipboard icon

This section is only useful as an anchor link target.


  1. Footnote text goes here.