Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format that is simple to convert to structurally valid HTML. Markdown was created by John Gruber in 2004 and enjoys wide popularity.
Note that you can always mix HTML tags directly into Markdown ﬁles, should you need to do something beyond the limits of the Markdown.
Bold and italics
Surrounding text with two asterisks makes text bold:
**This text will be bold.**
To create italics, use a single asterix (*) on either side of the text:
*This text will be italic.*
Both * or _ symbols work to make text bold or italic. This way you can combine bold and italic in the same sentence. For example:
**Everyone _must_ listen.**
You can create headings using the octothorpe (#).
# Largest heading
Use two octothropes to create a subheading.
Alternatively, for H1 and H2, an underline-ish style:
Alternative heading =================== Alternative subheading ----------------------
Create a text link by wrapping the linked text in brackets [ ], and then wrapping the link in parenthesis ( ). For example:
Use the syntax for a link, with an exclamation point (!) in front. For example:
Make a bulleted list by preceding list items with a single hyphen (-) or an asterix (*). You need a space between the hyphen and the text.
- Round - Shell - Projectile
Create a numbered list by preceding list items with a number.
1. Eins 2. Deux 3. Tres
Use square brackets and a caret (^) to mark the position of a footnote in your text:
Use this syntax.[^1] Another line with a different footnote.[^2]
And then write the footnotes themselves at the bottom of your ﬁle like this:
[^1]: And the note goes here. [^2]: And the second goes here too.
You can also write footnotes inline with your text:
Use this syntax ^[Footnote text goes here] for inline footnotes.
Strike out text
Put a double tilde (~) on either side of the text you want to strikethrough:
~~Strike out mistakes~~
Indent code with four spaces:
var foo = “bar”;
You can also wrap code with three backticks (`) and specify the language to enable syntax highlighting:
You can customize your code’s syntax highlighting by modifying the highlight.js CSS ﬁle which comes with your blog’s template.
Use three or more hyphens (-), asterisks (*) or underscores (_) to create a horizontal rule.
Markdown uses email-style > characters for block quoting. They are presented as:
> This is a blockquote with two paragraphs. > > This is the second pragraph. Vestibulum enim wisi.
You can mix HTML tags directly into Markdown ﬁles, should you need to do something beyond the limits of the Markdown.