Markdown

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.

## Subheading

Alternatively, for H1 and H2, an underline-ish style:

Alternative heading
===================

----------------------

Create a text link by wrapping the linked text in brackets [ ], and then wrapping the link in parenthesis ( ). For example:

[Wikipedia](https://wikipedia.org)

Images

Use the syntax for a link, with an exclamation point (!) in front. For example:

![Image title](https://url.of/the/image.jpg)

Lists

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

Footnotes

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~~

Code

Indent code with four spaces:

    var foo = “bar”;


You can also wrap code with three backticks () and specify the language to enable syntax highlighting:

javascript
var foo = "bar";


You can customize your code’s syntax highlighting by modifying the highlight.js CSS ﬁle which comes with your blog’s template.

Horizontal rules

Use three or more hyphens (-), asterisks (*) or underscores (_) to create a horizontal rule.

---

***

___

Blockquotes

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.`

HTML

You can mix HTML tags directly into Markdown ﬁles, should you need to do something beyond the limits of the Markdown.