Руководство по Markdown

150 руководств есть, а своего не хватает.

В статье используется синтакис Markdown Extra

Заголовок

# Первого уровня
## Вторго уровня
### Третьего уровня

Цитата

> Вы держитесь здесь, вам всего доброго, 
> хорошего настроения и здоровья

Ненумерованный список

* Украл
* Выпил
* В тюрьму

Нумерованный список

1. Пришёл
2. Увидел
3. Победил

Ссылка

[Тяпк](http://tyapk.ru)

Если ссылок много, то можно так

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]: http://google.com/        "Google"
[2]: http://search.yahoo.com/  "Yahoo Search"
[3]: http://search.msn.com/    "MSN Search"

Картинка

![alt-текст](http://example.ru/image.jpg)

Абзац с новой строки

Вариант 1 - два пробела в конце предыдушего абзаца
Вариант 2 - пустая строка между абзацами

Выделение текста

*курсив*
**жирный**

Таблицы - единственная неудобная вещь в markdown

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell 
Content Cell  | Content Cell 

Затекстовая ссылка

— Скажи-ка, дядя, ведь не даром[^1]
[^1]: М.Ю.Лермонтов. Бородино

Аббревиатуры

*[BGP]:  Border Gateway Protocol
*[HTML]: Hyper Text Markup Language

Горизонтальная линия

---

Картинка или ссылка с классом и идентификатором

![alt-текст](http://example.ru/image.jpg){#id .class}
[Тяпк](http://tyapk.ru){#id .class}

Экранирование спецсимволов обратным слешем \

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

Код в строке - обратными кавычками `

I strongly recommend against using any `<blink>` tags.

I wish SmartyPants used named entities like `—`
instead of decimal-encoded entites like `—`.

Код в блоке кода

```javascript  
left = typeof left != "number" ? 0 : left;
right = typeof right != "number" ? items.length - 1 : right;

index = partition(items, left, right);

if (left < index - 1) {
    quickSort(items, left, index - 1);
}  
```.

Можно вставлять HTML код

<blockquote>
        <p>Сырая цитата</p>
</blockquote>

<pre class="line-numbers">
<code class="language-javascript">function sayHi(name) {
  var phrase = "Привет, " + name;
  alert( phrase );
}
</code>
</pre>

Mastering Markdown