Синтаксис Markdown: шпаргалка с примерами

Как читать пометки

После каждого приёма — пометка, что ProsaMD делает с файлом при сохранении. Проще показать:

*курсив*

_курсив_

<div>привет</div>

«Полностью» — файл не меняется. «С нормализацией» — документ тот же, но запись приводится к одному виду: как _курсив_, записанный звёздочками. «Как текст» — разметка не исполняется и показывается исходником. Нормализация бывает только при сохранении из визуального редактора; режим «Код» всегда сохраняет файл побайтово. Пометки описывают ProsaMD 0.1.10.

Заголовки полностью

От одного до шести решёток перед текстом. Решётка и текст разделяются пробелом.

# Заголовок первого уровня
## Заголовок второго уровня
### Заголовок третьего

Абзацы и переносы полностью

Пустая строка начинает новый абзац. Перенос внутри абзаца — тремя способами: просто перевести строку (ProsaMD покажет новую строку, как Typora и Obsidian; GitHub склеил бы в одну), обратный слэш в конце строки или два пробела. Пробелы не видно — это последний абзац примера.

Просто перевод строки —
вторая строка того же абзаца.

Явный перенос — слэш в конце строки:
вторая строка.

Два пробела в конце строки:  
вторая строка.

Выделение текста с нормализацией

Жирный — двойные звёздочки, курсив — одинарные. Зачёркивание — двойные тильды (расширение GitHub). Подчёркивания _так_ тоже работают; при сохранении ProsaMD приводит их к звёздочкам.

**жирный** и *курсив*,
а также ***жирный курсив***.

~~зачёркнутый~~

Списки с нормализацией

Маркированный список — дефис, звёздочка или плюс; нумерованный — цифра с точкой. Вложенность — отступ. При сохранении ProsaMD записывает список единым стилем (дефисы, свои отступы).

- купить кофе
- заварить
  - не спеша

1. открыть файл
2. прочитать
3. сохранить

Чек-листы полностью

Пункт списка с квадратными скобками: пробел — пустая галочка, x — отмеченная. Расширение GitHub.

- [x] открыть .md-файл
- [ ] рассказать миру

Цитаты с нормализацией

Знак «больше» перед абзацем. Цитаты вкладываются друг в друга удвоением знака.

> Читается как обычный текст,
> но с полосой слева.

Код полностью

Строчный фрагмент — в обратные кавычки. Блок — три обратные кавычки до и после; язык сразу после открывающих кавычек включает подсветку.

Сочетание `Ctrl+/` переключает режим.

```js
const answer = 42;
```

const answer = 42;

Таблицы с нормализацией

Строка заголовков, строка с дефисами, затем строки данных. Двоеточия задают выравнивание колонки: по левому краю, по центру, по правому. Расширение GitHub.

| Приём | Значок | Часто |
|:----- |:------:| -----:|
| Заголовок | # | да |
| Курсив | * | да |

При сохранении из визуального редактора ProsaMD выравнивает ширину колонок — таблица остаётся таблицей, меняется только набор пробелов.

Ссылки полностью

Текст в квадратных скобках, адрес — в круглых. Подсказка при наведении — в кавычках после адреса. Адрес в угловых скобках превращается в ссылку сам.

[Сайт ProsaMD](https://prosamd.ru)
[С подсказкой](https://prosamd.ru "ProsaMD")
<https://prosamd.ru>

Картинки полностью

Как ссылка, но с восклицательным знаком. В квадратных скобках — подпись для программ чтения с экрана, в кавычках после адреса — всплывающая подсказка. Картинка становится ссылкой, если обернуть её в ещё одну ссылку.

![Знак ProsaMD](/assets/img/prosamd-symbol.svg)

![Знак](/assets/img/prosamd-symbol.svg "Подсказка")

[![Знак-ссылка](/assets/img/prosamd-symbol.svg)](https://prosamd.ru/)

В ProsaMD картинки, лежащие рядом с документом (например, в папке assets/), открываются по относительному пути; вставка из буфера обмена сохраняет файл рядом с документом.

Горизонтальная линейка с нормализацией

Три и более дефисов, звёздочек или подчёркиваний на отдельной строке. При сохранении записывается тремя дефисами.

Текст до линейки

---

Текст после

Сноски полностью

Знак сноски — квадратные скобки с крышкой: внутри номер или слово. Определение — в любом месте документа. ProsaMD в режиме «Просмотр» собирает сноски внизу документа, а по номеру возвращает к месту в тексте.

Утверждение, требующее оговорки[^1].

[^1]: Текст оговорки.

Экранирование и символы с нормализацией

Обратный слэш перед значком разметки показывает его как обычный символ. HTML-сущности вроде © при сохранении превращаются в сами символы.

\*не курсив\*, а звёздочки

© 2026 — станет символом ©

HTML и эмодзи как текст

Вставки HTML и коды вида :tada: ProsaMD не исполняет: они хранятся в файле и показываются как текст. Эмодзи вставляйте напрямую — 🎉. Показ строчных тегов <kbd>, <sub>, <sup> — в планах.

<div>Блок HTML</div>

:tada: — останется текстом

Front-matter полностью

Служебный блок между двумя линиями из дефисов в начале файла — его читают генераторы сайтов (Jekyll, Hugo) и Obsidian. В визуальном редакторе и Просмотре ProsaMD показывает его первой карточкой документа — серой служебной записью с тем же текстом, что в файле. Меняют блок в режиме «Код»; в файл он возвращается без изменений. Если внутри блока есть пустая строка — это уже не front-matter: линии станут линейками, текст — абзацем.

---
title: Заметки
---

# Текст документа

Редкая запись с нормализацией

Кроме основных приёмов у Markdown есть синонимы: заголовки подчёркиванием (=== под текстом), заборы из тильд ~~~, код отступом в четыре пробела. ProsaMD читает их все; при сохранении из визуального редактора приводит к каноничной записи. Ссылки-определения ([метка]: адрес внизу документа) сохраняются: блок переносится в конец документа, а сами ссылки записываются обычной, инлайн-формой.

Заголовок подчёркиванием
=========================

Текст под ним.