Редактор Markdown

Этот редактор Markdown онлайн показывает ваш текст слева, а отформатированный результат справа, и предпросмотр меняется при каждом нажатии клавиши. Он понимает Markdown, который используется на GitHub, в файлах README, в вики и в приложениях для заметок вроде Obsidian: заголовки, списки, списки задач, таблицы, код, цитаты, ссылки, изображения и сноски. Учётная запись не нужна, и ничего из того, что вы вводите, никуда не отправляется.

Как пользоваться редактором Markdown онлайн

1. Введите или вставьте Markdown в левое поле либо откройте файл .md кнопкой файла на панели инструментов. Файл можно также перетащить в любое место редактора.
2. Следите за предпросмотром справа. Синхронная прокрутка показывает в обеих частях одно и то же место документа, какую бы из них вы ни прокручивали.
3. Форматируйте текст кнопками панели инструментов или сочетаниями клавиш, например Ctrl+B для полужирного и Ctrl+K для ссылки.
4. Скопируйте результат как Markdown, как HTML или как форматированный текст либо скачайте его в виде файла .md, .pdf, .docx, .html или .txt.

Редактор открывается с коротким примером «Заметки по проекту», в котором есть все распространённые элементы, так что синтаксис и его результат видны рядом ещё до того, как вы начнёте писать свой текст.

Редактор Markdown с живым предпросмотром

Над редактором можно выбрать один из трёх режимов. Рядом показывает Markdown и предпросмотр бок о бок, Редактор отдаёт всю ширину тексту, а Просмотр показывает только результат и работает как простой просмотрщик Markdown для файла, который вам прислали. На телефоне редактор переключается между режимами Редактор и Просмотр, потому что две колонки были бы слишком узкими для чтения.

Предпросмотр отображает Markdown так же, как GitHub: по спецификации CommonMark с расширениями GitHub Flavored Markdown (оба на английском), которые добавляют таблицы, списки задач, зачёркивание и автоматические ссылки. Заголовки получают якоря, как на GitHub, поэтому на ## План релиза можно сослаться как на #план-релиза, а щелчок по такой ссылке прокручивает предпросмотр к заголовку. Сноски, записанные как [^1], нумеруются в порядке первого упоминания и перечисляются в конце.

Текстовое поле использует проверку орфографии вашего браузера, поэтому слова с ошибками подчёркиваются прямо во время ввода. Под редактором видно количество слов и символов и время чтения. При подсчёте синтаксис Markdown не учитывается, поэтому у заголовка, отмеченного ##, считаются только его слова. Чтобы посчитать ещё и предложения с абзацами, вставьте текст в счётчик слов и символов.

Панель инструментов и сочетания клавиш

На панели инструментов есть всё, что нужно для обычного документа: Заголовок, Полужирный, Курсив, Зачёркнутый, Встроенный код, Ссылка, Изображение, Цитата, Блок кода, Маркированный список, Нумерованный список, Список задач, Таблица и Горизонтальная линия. Сначала выделите текст, и кнопка обрамит его разметкой; нажмите ту же кнопку ещё раз, и символы разметки исчезнут. Без выделения кнопка вставляет короткий текст-заполнитель, который уже выделен, так что вы просто вводите поверх него.

Несколько деталей экономят время:

• Заголовок переключает текущую строку по кругу: #, ##, ### и обратно в обычный текст.
• Ссылка превращает выделенные слова в [слова](https://) и выделяет часть с адресом, чтобы вы сразу вставили URL. Если же выделить URL, он станет адресом.
• Кнопки списков и Цитата работают сразу со всеми выделенными строками. Если нажать Нумерованный список на маркированном списке, он станет нумерованным.
• Нажмите Enter в конце пункта списка, и следующий пункт начнётся с нужного маркера. Номера увеличиваются, новая задача начинается неотмеченной, а Enter на пустом пункте завершает список. Tab и Shift+Tab увеличивают и уменьшают отступ пунктов списка.
• Любое изменение, сделанное кнопкой или сочетанием клавиш, можно отменить с помощью Ctrl+Z.

Все сочетания перечислены в разделе Сочетания клавиш под редактором. На Mac вместо Ctrl в них используется клавиша Command.

Вставка из Word или Google Docs с преобразованием в Markdown

Когда вы вставляете текст, скопированный из Word, Google Docs или с веб-страницы, редактор превращает его форматирование в Markdown, а не отбрасывает его. Заголовки становятся строками с #, полужирный текст и курсив получают свои звёздочки, ссылки сохраняют адреса, маркированные и нумерованные списки (включая многоуровневые списки Word) становятся списками Markdown, а таблицы превращаются в таблицы Markdown с первой строкой в качестве заголовка. Это самый быстрый способ перенести готовый документ в README или в вики.

Если вам нужен был просто текст, нажмите Вставить как обычный текст в уведомлении, которое появляется после вставки, или вставляйте с помощью Ctrl+Shift+V. Код, скопированный из VS Code или другого редактора кода, и текст, который уже написан в Markdown, вставляются в точности как есть.

Шпаргалка по синтаксису Markdown

Самый распространённый синтаксис на одном экране. Введите в редактор то, что в левом столбце, и в предпросмотре появится то, что в правом.

Вы вводите	Вы получаете
# Заголовок, ## Раздел, ### Подраздел	Заголовки уровней от 1 до 3 (до 6 с ######)
**полужирный** и *курсив*	полужирный и курсив
~~старое~~	старое
`код`	код моноширинным шрифтом
[текст](https://example.com)	ссылка
	изображение
- пункт или 1. пункт	маркированный или нумерованный список
- [ ] задача и - [x] готово	список задач с флажками
> цитируемый текст	цитата
три обратных апострофа на строке до и после кода	блок кода
--- на отдельной строке	горизонтальная линия
текст[^1] и [^1]: примечание	сноска

Таблице Markdown нужна строка заголовка, разделительная строка из дефисов и затем по одной строке на каждую строку таблицы, а ячейки разделяются символом |. Двоеточие в разделительной строке задаёт выравнивание: :-- выравнивает по левому краю, :-: по центру, а --: по правому краю. Кнопка Таблица вставляет готовую таблицу из трёх столбцов, с которой можно начать. В исходном тексте ячейки не обязательно выравнивать, но выровненную таблицу потом проще править.

Для того, что не имеет своего синтаксиса, Markdown принимает HTML, например <kbd>Ctrl</kbd> для клавиш, <sub> и <sup> для H₂O и x² или <details> для раздела, который раскрывается по щелчку. Скрипты, стили и формы удаляются из предпросмотра ради безопасности.

Копирование с форматированием или скачивание файла

Копировать Markdown копирует исходный текст, Копировать HTML копирует чистый HTML, готовый для сайта или CMS, а Копировать с форматированием копирует отформатированный результат. Вставьте его в Google Docs, Word, Outlook или Gmail, и заголовки, полужирный текст, списки, ссылки и таблицы появятся уже отформатированными, без символов Markdown.

Кнопки Скачать сохраняют документ в одно нажатие как Markdown, PDF, Word, HTML или обычный текст и называют файл по названию из front matter или по первому заголовку. Они используют разумные настройки по умолчанию: бумага A4 (Letter в США, Канаде, Мексике и других странах, где это стандарт), обычные поля и шрифт размером 11 пунктов. Чтобы выбрать размер страницы, шрифты и поля, добавить оглавление или преобразовать несколько файлов сразу, нажмите Дополнительные настройки экспорта: откроется конвертер Markdown, в котором ваш текст уже вставлен.

Часто задаваемые вопросы

Загружается ли мой текст на сервер или куда-нибудь сохраняется?

Нет. Предпросмотр, преобразование и скачивание происходят в вашем браузере, и текст никогда не отправляется на сервер. По умолчанию ничего и не сохраняется, поэтому после закрытия вкладки текст пропадает. Если отметить Запоминать черновик в этом браузере, текст после каждого изменения сохраняется в хранилище вашего браузера и возвращается при следующем посещении. На общем компьютере снимите эту отметку, при этом удалится и сохранённый черновик.

Как открыть и просмотреть файл .md онлайн?

Нажмите кнопку файла на панели инструментов или перетащите файл в редактор, затем переключитесь на Просмотр, чтобы читать его как отформатированный документ. Файлы размером до 20 МБ в кодировке UTF-8 или UTF-16 открываются сразу. Изображения из файла показываются, если у них указан полный веб-адрес; изображения, которые лежат рядом с файлом на вашем компьютере, веб-страница загрузить не может.

Какой вариант Markdown использует редактор?

Он работает по спецификации CommonMark (на английском), стандарту, которого придерживается большинство инструментов Markdown, и поддерживает расширения GitHub: таблицы, списки задач, зачёркивание, автоматические ссылки и сноски. Текст, написанный для GitHub, GitLab, Obsidian, Reddit или Discord, выглядит здесь так же, за исключением функций, которые эти сервисы добавляют поверх, например упоминаний пользователей или вики-ссылок Obsidian.

Как перенести Markdown в Google Docs?

Нажмите Копировать с форматированием и вставьте текст в документ. Заголовки, списки, ссылки и таблицы сохранят форматирование. Новые версии Google Docs умеют читать Markdown и сами. В русском интерфейсе он называется разметкой: когда в меню «Инструменты», «Настройки» отмечен пункт «Включить разметку», команда «Вставить из разметки» доступна в меню «Правка» и в контекстном меню.

Поддерживает ли редактор диаграммы Mermaid или формулы LaTeX?

Пока нет. Блок Mermaid отображается как обычный блок кода, а формулы, записанные как $...$, остаются обычным текстом. Всё остальное из GitHub Flavored Markdown поддерживается.

Что такое Markdown и кто им пользуется?

Markdown представляет собой способ форматировать обычный текст несколькими символами. Его создал Джон Грубер в 2004 году, чтобы документ оставался читаемым даже до преобразования в HTML (подробнее в Википедии). Разработчики пишут на нём файлы README и документацию, авторы ведут в нём заметки и черновики, а чаты с ИИ отвечают в Markdown, поэтому их ответы, вставленные в другое место, пестрят звёздочками и решётками.

Другие инструменты для текста собраны в категории Текст: сравните две версии документа, чтобы увидеть, что изменилось, или измените регистр заголовков за один раз. Разработчики найдут JSON formatter и другие инструменты в категории Разработчики.