Markdown

Markdown (.md) — лёгкая разметка текста, создана Джоном Грубером в 2004 году. Идея: писать почти как обычный текст, чтобы даже без рендера читалось нормально, а рендер выдавал структурированный HTML.

Базовый синтаксис

# Заголовок 1
## Заголовок 2
### Заголовок 3

**жирный**   *курсив*   ~~зачёркнутый~~   `код`

- список
- ещё пункт
  - вложенный

1. нумерованный
2. пункт

[ссылка](https://example.com)
![картинка](image.png)

> цитата

---

three backticks python
код блоком
three backticks

Диалекты

• CommonMark — стандартизированная спецификация без разночтений.
• GFM (GitHub Flavored Markdown) — добавляет таблицы, чекбоксы - [ ], автолинки, зачёркивание, code fences с языком.
• MDX — Markdown + JSX-компоненты (React). Next.js, Docusaurus.
• Notion-flavored MD — с цветами, колонками, toggle-блоками.

Где применяется

• README в репозиториях (GitHub, GitVerse, Codeberg).
• Gist, тикеты, PR, комментарии на всех Git-хостингах.
• Telegram (MarkdownV2 в ботах).
• Discord, Slack, Mattermost.
• Статические генераторы сайтов: Hugo, Jekyll, Zola, MkDocs, Docusaurus, VuePress.
• Obsidian, Zettlr, Notion.

Инструменты

• Рендер: pandoc, marked, markdown-it, commonmark.js.
• Редакторы: Obsidian, Typora, Mark Text, Ghostwriter, Zettlr, VS Code preview.
• Linter: markdownlint.

Плюсы и минусы

+ Читается без рендера, писать быстро, поддерживается везде, git-friendly (diff по строкам).

− Ограниченный набор фич, диалекты несовместимы, нет строгой типографики.

Альтернативы

• reStructuredText (.rst) — Python-документация, Sphinx.
• AsciiDoc (.adoc) — мощнее MD.
• Org-mode — Emacs, самая мощная plain-text разметка.

См. также

• README, Репозиторий, Gist, Git