Markdown Examples...
-
Headers
Headers exist for H4 and H5, also. Use four and five hashes, respectively. Note there must be a space between the hashes and the text.Markdown Result An h1 Header ============ # Alternate Syntax for H1
An h1 Header
Alternate Syntax for H1
Ah h2 Header ----------------- ## Alternate Syntax for H2
Ah h2 Header
Alternate Syntax for H2
### An h3 Header
An h3 Header
Text styles, unordered lists, block quotes
Paragraphs are separated by a blank line.
Markdown Result *Italic*, **bold**, and `monospace`. Itemized lists look like: * this one * that one * the other one ^ | column four Line breaks in text are honored, also.
Italic, bold, and
monospace
.Itemized lists look like:
- this one
- that one
- the other one
Note that - not considering the asterisk - the actual text content starts at four columns in.
Line breaks in
text are
honored, also.Unicode characters are supported. ☺
Markdown Result > Block quotes are written like so. >> >>Doubly nested quotes are possible. > > They can span multiple paragraphs, if you like.
Block quotes are written like so.
Doubly nested quotes are possible.
They can span multiple paragraphs, if you like.
Ordered lists
Markdown Result Here's a numbered list: 1. first item 1. second item 1. nested item 1. nested item 1. third item
(numbering of the list is arbitrary, they can all be #1
and will be auto numbered in the list.)Here's a numbered list:
- first item
- second item
- nested item
- nested item
- third item
Code Blocks
Note again how the actual text starts at five columns in (five characters from the left side). Any block of text indented with four spaces will be automatically converted to a code block. Here's a code sample:
Markdown Result four spaces ----------- sp sp sp sp # Let me re-iterate ... sp sp sp sp for i in 1 .. 10 { do-something(i) } ^ | column five
# 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, if you like:
~ ~ ~ (three tildes, but no spaces between) define foobar() { print "Welcome to flavor country!"; } ~ ~ ~
(which makes copying & pasting easier). You can optionally mark the delimited block for syntax highlighting:
~ ~ ~python (again, no spaces between the tildes) import time # Quick, count to ten! for i in range(10): # (but not *too* quick) time.sleep(0.5) print i ~ ~ ~
The examples above show the tildes with spaces between just so they'll show up in the formatted output, otherwise it just notes it as the start or end of another block.
Nested Lists
Markdown Result 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) Do not bump wooden spoon or it will fall.
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 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)
Do not bump wooden spoon or it will fall.
Notice again how text always lines up on 4-space indents (including that last line which continues item 3 above).
Links
Markdown Result Here's a link to [a website](http://foo.bar), to a [local doc](local-doc.html), and to a [section heading in the current doc](#an-h2-header).
Here's a link to a website,
to a local doc,
and to a section heading in the current doc.Tables
Tables can look like this:
Markdown Result | size | material | color | |:----:|-------------|-------------:| |9 | leather | brown | |10 | hemp canvas | natural | |11 | glass | transparent |
Alignment can be controlled by the placement of ":" in the
dashes line.:-----:
for centered,------:
for right
alignment. Default is left.size material color 9 leather brown 10 hemp canvas natural 11 glass transparent Table: Shoes, their sizes, and what they're made of
Colored Text
In the toolbar above the editing window, there's an eyedropper on the far right. Select your text, then click the dropper, select a color, then click the little color wheel looking button in the bottom right of the popup. You can make %(#de0303)[RED TEXT]!
Alternately, if you know the HTML color code, you can just type it directly as in the below example.
Warning: Changing the colors can produce text that's unreadable on some themes. Not everybody uses the same theme as YOU.
Markdown Result Create some %(#33FF33)[Green] text. HTML color names are supported for %(red)[text] also. And %(#888)[short color] specs, also.
Create some %(#33FF33)[Green] text.
HTML color names are supported for %(red)[text] also.
And %(#888)[short color] specs, also.Misc
Horizontal rules can be either multiple asterisks or dashes on a line by itself.Markdown Result A horizontal rule follows. _(can be hard to see in some themes, but adds a break none the less)_ **** Emoticons: :smile:, :frowning:, :wink: , etc.
A horizontal rule follows. (can be hard to see in some themes, but adds a break none the less)
Emoticons: :smile:, :frowning:, :wink: , etc. :)
When you type a colon, the emoticon picker pops up, and you can start typing to narrow the list
:smile:
for example, just type colon, then 's', then 'm' and pick from the list.