Редактор Markdown
Работает на устройстве. Ничего не отправляется.Всё происходит на вашем устройстве. Ничто из введённого вами никуда не отправляется.
Markdown
Предпросмотр
Ваш отрендеренный предпросмотр появится здесь
Пишите Markdown с живым предпросмотром, затем экспортируйте чистый HTML или исходный файл Markdown, полностью в браузере.
Этот редактор преобразует Markdown в HTML в реальном времени по мере ввода, полностью в вашем браузере, и поддерживает синтаксис, которым люди реально пользуются каждый день: заголовки, полужирный и курсивный текст, ссылки, изображения, списки, цитаты, инлайн-код и блоки кода. Всё, что вы вводите, экранируется как HTML до применения любого форматирования, поэтому вставленный HTML или теги script отображаются как обычный видимый текст, а не выполняются - ничто из написанного вами никогда никуда не загружается.
Часто задаваемые вопросы
Это полная спецификация CommonMark?
Нет - здесь охвачен наиболее часто используемый синтаксис (заголовки, выделение, ссылки, изображения, списки, цитаты, код), а не полная спецификация CommonMark со всеми её нюансами, такими как вложенные списки, таблицы или сноски. Для повседневных заметок, README и документации это основное подмножество охватывает подавляющее большинство реального Markdown.
Безопасно ли вставлять Markdown из источника, которому я не полностью доверяю?
Да. Каждый введённый или вставленный символ экранируется как HTML до применения какого-либо форматирования Markdown, а URL-адреса ссылок или изображений проверяются по белому списку безопасных схем (http, https, mailto и относительные пути) перед использованием - вставленная ссылка javascript: или встроенный тег <script> отображаются как безобидный видимый текст, а не выполняются.
В чём разница между загрузкой HTML и Markdown?
Загрузка Markdown сохраняет именно то, что вы написали, в виде файла .md, для дальнейшего редактирования или коммита в репозиторий. Загрузка HTML сохраняет отрендеренный результат в виде отдельного файла .html, готового для вставки в CMS, письмо или куда угодно ещё, где ожидается готовый HTML, а не исходник Markdown.
Почему в предпросмотре пропали мои переносы строк?
Парсер следует стандартным правилам абзацев Markdown: строки, не разделённые пустой строкой, объединяются в один абзац, а каждый перенос строки сворачивается в один пробел. Если вам нужен новый абзац, оставьте пустую строку между блоками текста - однократное нажатие Enter не создаст видимого разрыва в итоговом результате.
Поддерживает ли блок кода подсветку синтаксиса для языка вроде ```js?
Пока нет - язык, который вы указываете после открывающих тройных обратных кавычек, используется только для обозначения начала блока и отбрасывается, не отображаясь и не окрашиваясь. Всё внутри ограждения экранируется и отображается как обычный моноширинный текст, поэтому ваш код остаётся точно таким, как был набран, просто без цветовой подсветки синтаксиса.
Поддерживаются ли таблицы?
Пока нет - этот парсер сосредоточен на синтаксисе, которым люди пользуются чаще всего, а таблицы с разделителями-вертикальными чертами в этот набор не входят. Таблица, написанная в синтаксисе Markdown, отобразится как обычный текст абзаца, а не как настоящая таблица, поэтому пока таблицы нужно писать напрямую в HTML, если они нужны вам в экспортированном результате.
Поддерживаются ли вложенные списки?
Нет - каждый элемент списка обрабатывается как плоский, независимо от отступов в начале строки, поэтому отступ строки для создания вложенного списка не приведёт к появлению вложенного списка; вместо этого он отобразится как ещё один элемент верхнего уровня. Если вам нужна иерархия, ближайший обходной путь - оформить её заголовками или ручными отступами внутри блока кода.
Имеет ли значение, использую ли я * или _ для полужирного и курсива?
Нет - оба варианта обрабатываются одинаково. **жирный** и __жирный__ дают полужирный текст, а *курсив* и _курсив_ дают курсивный текст. Кнопки B и I на панели инструментов всегда вставляют вариант со звёздочками, но ввод варианта с подчёркиванием работает точно так же.
Можно ли зачеркнуть текст с помощью ~~вот так~~?
Сейчас нет - зачёркивание не входит в синтаксис, распознаваемый этим парсером, поэтому ~~текст~~ отображается буквально как тильды вокруг обычного текста, а не как зачёркнутый текст. Это одно из более распространённых расширений за пределами базового Markdown, которое этот инструмент пока не поддерживает.
Какими разными способами можно написать горизонтальную линию?
Три или более дефисов, звёздочек или подчёркиваний на отдельной строке - ---, *** или ___ - все они отображаются как горизонтальная линия. Кнопка ― на панели инструментов всегда вставляет вариант с дефисами, но все три варианта работают одинаково, если вы вводите их сами.
Может ли цитата занимать несколько абзацев?
Каждый блок последовательных строк, начинающихся с >, отображается как один абзац внутри цитаты, с переносами строк, сворачиваемыми в пробелы, точно так же как в обычных абзацах. Оставить пустую строку цитаты, чтобы начать второй абзац внутри той же цитаты, не поддерживается - вместо этого это завершает цитату.
Могу ли я вставить форматированный текст из Word или Google Документов?
Вы можете вставить в редактор, но только как обычный текст - браузеры удаляют расширенное форматирование (полужирный, заголовки, ссылки) при вставке в поле обычного текста, поэтому слова сохраняются, а форматирование автоматически не превращается в синтаксис Markdown. Вам нужно будет заново применить заголовки, полужирный текст и ссылки самостоятельно - именно для этого предназначены кнопки на панели инструментов над редактором.
Что делают кнопки над редактором?
Каждая вставляет соответствующий синтаксис Markdown в позицию курсора или оборачивает им выделенный текст - нажмите B с выделенным словом, и оно станет **словом**, нажмите H2 на пустой строке, и она станет заголовком. Это ярлык для точного синтаксиса, который понимает этот парсер, а не отдельная система форматирования.
Есть ли ограничение на объём текста, который можно вставить?
Жёстко заданного ограничения нет, но весь документ заново разбирается с нуля при каждом нажатии клавиши, полностью в основном потоке вашего браузера. Для заметок и статей это происходит мгновенно, но очень большой документ (десятки тысяч строк) может начать ощущаться медленнее при вводе, поскольку инкрементального или фонового разбора нет.
Работает ли это так же для языков с письмом справа налево, таких как арабский или персидский?
Да - для этих языков раскладка страницы переключается на направление справа налево, и отрендеренный предпросмотр следует тому же направлению, поэтому заголовки, списки и абзацы читаются естественно. Сам синтаксис Markdown (#, *, > и т. д.) остаётся полностью одинаковым независимо от языка.
Для разработчиков: откройте эту страницу с параметром `q` в URL - например, gizke.com/markdown?q=# Hello world - и это значение будет автоматически подставлено. Большинству посетителей это не нужно; это предназначено для прямых ссылок на готовый к использованию пример.