Markdown -- это упрощенный язык разметки, который преобразует (почти) обычный текст в html-страницу. Создан в 2004 году Джоном Грубером и Аароном Шварцем, затем был дополнен и адаптирован для различных приложений.
Markdown-файлы имеют расширение .md или .markdown
Ниже в серых блоках содержится то, как выглядит текст на стадии разметки, сразу после блока находится результат.
Заголовки в Markdown выделяются решетками #:
# заголовок 1 уровня
## заголовок 2 уровня
...
###### заголовок 6 уровня
Чтобы выделить текст курсивом, нужно поставить в начале и в конце фрагмента текста * или _ (не отделяя пробелом):
*звезды* или _нижние подчеркивания_
звезды или нижние подчеркивания
Чтобы сделать текст жирным, нужно поставить в начале и в конце фрагмента текста ** или __ (не отделяя пробелом):
**две звезды** или __два нижних подчеркивания__
две звезды или два нижних подчеркивания
Чтобы перечеркнуть текст, используйте ~~ в начале и в конце (не отделяя пробелом):
~~две тильды~~
две тильды
Нумерованные списки задаются так (уровни можно задать отступами):
1. первый элемент
2. второй элемент
3. третий элемент
4. четвертый элемент
1. пятый элемент
- первый элемент
- второй элемент
- третий элемент
- четвертый элемент
- пятый элемент
Маркированные списки задаются с помощью дефисов, астерисков или плюсов (уровни можно задать отступами):
+ первый элемент
- второй элемент
+ третий элемент
- четвертый элемент
* пятый элемент
- первый элемент
- второй элемент
- третий элемент
- четвертый элемент
- пятый элемент
Ссылки и адреса электронной почты можно вставить без всего или в угловых скобках:
<https://www.markdownguide.org>
https://www.markdownguide.org
<eee@mail.ru>
eee@mail.ru
https://www.markdownguide.org
https://www.markdownguide.org
Если нужно сделать гиперссылку, то она оформляется так:
[текст](https://www.markdownguide.org)
Можно добавить всплывающий при наведении комментарий:
[текст](https://www.markdownguide.org "это поможет")
Чтобы вставить картинку, нужно написать следующую строку (без пробелов):
Например:
Строки в таблице разделяются переходом на новую строку, столбцы вертикальной чертой (|)
Между заголовком и телом таблицы вставляется строка с --- в каждой ячейке. Выравнивание задается положением двоеточия:
1|2|3
---|:---:|---:
да|нет|не знаю
не знаю|нет|да
нет|не знаю|да
нет|да|не знаю
да|не знаю|нет
не знаю|да|нет
| 1 | 2 | 3 |
|---|---|---|
| да | нет | не знаю |
| не знаю | нет | да |
| нет | не знаю | да |
| нет | да | не знаю |
| да | не знаю | нет |
| не знаю | да | нет |
- GitHub
- Telegram
- Tumblr
- R, Python ...
Изначальная страница проекта (сейчас неактивна)
Наиболее полное руководство
Cheatsheet (сжатый конспект)
Help от гитхаба
Фичи для продвинутых от гитхаба
Вдохновляющий набор расширений и приложений, где используется Markdown (там есть, в том числе, про то, как делать презентации и документы, а также писать красивые письма)
Курс на codeacademy