Материал с сайта : http://rukeba.com/by-the-way/markdown-sintaksis-po-russki/
Markdown - это легковесный язык разметки текста для веба. Был создан для удобства чтения и написания размеченных текстов. Движок markdown генерирует валидный XHTML. Авторы - John Gruber и Aaron Swartz. Официальная страница проекта и более подробная документация на сайте Daring Fireball.
Ниже привожу короткий конспект, который, кстати, тоже написан на этом замечательном языке.
<пустая строка>
Текст параграфа. Может быть
разбит на несколько строк.
<пустая строка>
Что бы вставить перевод строки без начала нового параграфа, в конец нужно добавить два или больше пробелов.
Текст параграфа.<пробел><пробел>
Этот текст будет с новой строки.
Заголовок первого уровня H1
===========================
Заголовок второго уровня H2
---------------------------
или так
# Заголовок первого уровня H1
## Заголовок второго уровня H2
###### Заголовок шестого уровня H6
или так
# Заголовок первого уровня H1 #
## Заголовок второго уровня H2 ##
###### Заголовок шестого уровня H6 ######
> Это
> многострочная
> цитата
или так
> Это
многострочная
цитата
Ненумерованные:
* красный
* зеленый
* синий
или так
- красный
- зеленый
- синий
или даже так
+ красный
+ зеленый
+ синий
Нумерованные:
1. Первый
2. Второй
3. Третий
* * *
или так:
***
или так:
------
Инлайн ссылки
Это простая [ссылка](http://rukeba.com/) в тексте.
Это [ссылка](http://rukeba.com/ "Титул") с аттрибутом title.
Ссылки в справочном стиле
Это [ссылка][1] в справочном стиле.
...
...
[1]: http://rukeba.com/ "Необязательный титул"
Что бы урл в тексте стал ссылкой его нужно обрамить в < и >
По урлу <http://rukeba.com/> находится мой сайт.
Одинарные звездочки генерируют тег <em>
это *выделенный* текст
Двойные звёздочки генерируют тег <strong>
это **очень выделенный ** текст
Используйте функцию `printf()` для вывода.
![alt-текст](http://example.com/image.jpg "Необязательный титул")
или в справочном стиле:
![alt-текст][2]
...
...
[2]: http://example.com/image.jpg "Необязательный титул"
Для экранирования служебных символов маркдауна нужно использовать обратный слеш \
Ссылки
http://daringfireball.net/projects/markdown/
https://sourceforge.net/p/sitracker/wiki/markdown_syntax/
http://jonschlinkert.github.io/remarkable/demo/