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
A beta section BETA
The <Beta />
tag can be used inline BETA and should be applied self-closing
Paragraphs
Paragraphs are separated by a blank line.
Second paragraph. Italic, bold, italic bold, strikethrough, and inline code
.
Line Break
The backslash, \
, is interpreted as a new line.
This sentence should appear on a new line.
List items
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
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.
- This is the first list item.
- This is the second list item.
Here's some example code:
return shell_exec("echo $input | $markdown_script");
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)
Lists
Here's a numbered list:
- first item
- second item
- third item
Here's a nested ordered list:
- Step 1
- Sub-step 1
- Sub-step 2
- Sub Sub-step 1
- Sub Sub-step 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
.ConfigurationError
s are automatically turned intoConfigurationErrorDeliveryStopped
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)
Now a nested list:
First, get these ingredients:
- carrots
- celery
- lentils
Boil some water.
Dump everything in the pot and follow this algorithm:
find wooden spoonuncover potstircover potbalance wooden spoon precariously on pot handlewait 10 minutesgoto first step (or shut off burner when done)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
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) }
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));
Empty code blocks also work without breaking the build:
Links
Here's a link to a website, to a local doc, and to a section heading in the current doc. Here's a footnote 1.
Tables
Tables look like this:
Left Aligned | Center Aligned | Right Aligned |
---|---|---|
Hello | short | $1600 |
World | content | $12 |
zebra stripes | avoid insects | $1 |
Horizontal rules
Horizontal rules are not styled.
Constants
- 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
String literals
String literals have a customized font style for disambiguations and digits.
ABCDEFGHIJKLMNOPQRSTUVWXYZ
vs ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789
vs 0123456789capital I and small l = IlIlIl
vs capital I and small l = IlIlIl
Last section
This section is only useful as an anchor link target.
- Footnote text goes here.↩