Синтаксис Markdown (маркдаун) — облегчённый язык разметки
Заголовки
Обозначаются одним или несколькими символома # в начале строки.
Заголовок первого уровня
Заголовок второго уровня
Заголовок третьего уровня
…
Заголовок шестого уровня
Начертания текста
Выделяемый фрагмент текста обрамляется одной, двумя или тремя звездочками (*) с обеих сторон текста — в начале и в конце фрагмента.
- Курсив — Одной звездочкой
- Жирное начертание — Двумя звездочками
- Жирный курсив — Тремя звездочками
Цитаты
Обозначаются одним символом > в начале строки.
Буря мглою небо кроет,
Вихри снежные крутя;
Цитаты можно вкладывать друг в друга.
Первый уровень цитаты.
Второй уровень цитаты.
Продолжение первого уровня цитаты.
Пустая строка в цитатах означает «новый абзац». В этом случае каждую пустую строку необходимо отметить символом >.
Списки
Ненумерованный список
Обозначается любым из символов -*+ перед каждым элементом списка.
- Красный
- Зеленый
- Синий
Нумерованный список
Для нумерованного списка его элементы нумеруется.
- Раз
- Два
- Три
Порядок нумерации и само число не имеют значения, список будет пронумерован согласно порядку записи элементов.
Списки могут содержать в себе параграфы и цитаты. При этом семантически они действительно будут вложены тегами друг в друга.
Горизонтальная линия
Можно делать разными способами отбивая пустой строкой до и после.
Ссылки и изображения
У картинок вначале идет восклицательный знак !.
Можно вкладывать друг в друга — вместо названия ссылки вставляется картинка и ссылка становится кликабельной.
Изображения в ссылках
[
Ссылки сносками
Ссылки и картинки имеют дополнительный удобный синтаксис. Вместо «путей» можно использовать «теги», например, сначала написать текст разметив что и где должно находиться, а затем в виде сноски указать ссылку, при этом сноски визаульно в статье не отображаются.
I get 10 times more traffic from Google than from
Yahoo or MSN.
I get 10 times more traffic from Google than from
Yahoo or MSN.
Если название ссылки совпадает с названием тега, можно сделать и так:
I get 10 times more traffic from Google than from
Yahoo or MSN.
I get 10 times more traffic from Google than from
Yahoo or MSN.
При этом регистр не имеет значения. Картинки могут также:
Alt text
Сноски
Маркдаун может генерировать сноски. Для этого нужно после слова поставить тег сноски [^название_тега] и указать самоу сноску новым абзацем в любом месте документа [^название_тега]: текст тега. Сами сноски автоматически выведутся в конце документа.
В маркдауне есть умный синтаксис для ссылок и адресов электронной почты:
http://example.com/ и address@example.com
Во втором случае к ссылке добавилось mailto, что позволяет по клику запустить почтовую программу.