Markdown - это легковесный язык разметки текста для веба. Был создан для
удобства чтения и написания размеченных текстов. Движок markdown генерирует
валидный XHTML. Авторы - John Gruber и Aaron Swartz.
Официальная страница проекта и более подробная документация на сайте
Daring Fireball.
Ниже привожу короткий конспект, который, кстати, тоже написан
на этом замечательном языке.
Блочные Элементы
Параграфы
<пустая строка>
Текст параграфа. Может быть
разбит на несколько строк.
<пустая строка>
Переводы строк
Что бы вставить перевод строки без начала нового параграфа,
в конец нужно добавить два или больше пробелов.
Текст параграфа.<пробел><пробел>
Этот текст будет с новой строки.
Заголовки
Заголовок первого уровня H1
===========================
Заголовок второго уровня H2
---------------------------
или так
# Заголовок первого уровня H1
## Заголовок второго уровня H2
###### Заголовок шестого уровня H6
или так
# Заголовок первого уровня H1 #
## Заголовок второго уровня H2 ##
###### Заголовок шестого уровня H6 ######
Цитаты
> Это
> многострочная
> цитата
или так
> Это
многострочная
цитата
Списки
Ненумерованные:
* красный
* зеленый
* синий
или так
- красный
- зеленый
- синий
или даже так
+ красный
+ зеленый
+ синий
Нумерованные:
1. Первый
2. Второй
3. Третий
Код
Отступ в четыре пробела или один таб генерирует блок кода:
<пробел><пробел><пробел><пробел>print 'Hello, World!'
Горизонтальная линия
* * *
или так:
***
или так:
------
Строчные элементы
Ссылки
Инлайн ссылки
Это простая [ссылка](http://rukeba.com/) в тексте.
Это [ссылка](http://rukeba.com/ "Титул") с аттрибутом title.
Ссылки в справочном стиле
Это [ссылка][1] в справочном стиле.
...
...
[1]: http://rukeba.com/ "Необязательный титул"
Что бы урл в тексте стал ссылкой его нужно обрамить в < и >
По урлу <http://rukeba.com/> находится мой сайт.
Выделение
Одинарные звездочки генерируют тег <em>
это \*выделенный\* текст
Двойные звёздочки генерируют тег <strong>
это \*\*очень выделенный\*\* текст
Код в строке
Используйте функцию `printf()` для вывода.
Изображения
или в справочном стиле:
![alt-текст][2]
...
...
[2]: http://example.com/image.jpg "Необязательный титул"
Дополнительно
Экранирование
Для экранирования служебных символов маркдауна нужно использовать обратный слеш \
