Конвертер Markdown

Acrafto Team Текст
Обновлено

Блок front matter в начале документа не выводится. Название документа берётся из него: «Квартальный отчёт».

Результат
Квартальный отчёт

Этот документ показывает, что сохраняет конвертер: заголовки, списки, таблицы, код, цитаты, ссылки и сноски.1

Главное
  • Выручка выросла на 12 % по сравнению с прошлым кварталом
  • В сентябре к команде присоединились два новых сотрудника
  • На странице проекта приведены все цифры
Цифры
Месяц Заказы Изменение
Июль 1 240 +4 %
Август 1 310 +6 %
Сентябрь 1 395 +6 %
Следующие шаги
  1. Закончить руководство для новых сотрудников
  2. Проверить страницу с ценами
    • Сравнить со старой версией
    • Попросить у поддержки отзыв
  3. Спланировать следующий релиз
  • Собрать данные
  • Отправить отчёт

Числа округлены до целого заказа.

npm run build && npm run deploy

  1. Название берётся из блока YAML front matter в начале документа, который не выводится. ↩︎

Настройки

Конвертируйте Markdown в PDF, Word, HTML или обычный текст с помощью этого конвертера Markdown, который работает прямо в браузере: вставьте текст или откройте файл .md, выберите формат и скачайте результат. Он также превращает таблицы Markdown в файлы Excel или CSV, собирает электронные книги EPUB и документы LaTeX и переписывает Markdown для Jira, Confluence, Slack и форумного BBCode. Предпросмотр рядом с текстом показывает результат, пока вы меняете настройки. Ваши файлы никуда не загружаются, регистрация не нужна, нет ни водяного знака, ни ограничения на число страниц.

Как конвертировать файл Markdown

  1. Вставьте Markdown в левое поле или нажмите Открыть файлы и выберите один или несколько файлов .md. Файлы можно также перетащить на конвертер.
  2. Выберите формат в строке Преобразовать в. В группе Документы есть PDF, Word (DOCX), EPUB, LaTeX, HTML и Текст (TXT), в группе Таблицы есть Excel (XLSX) и CSV, а в группе Для приложений есть Jira / Confluence, Slack и BBCode.
  3. Проверьте предпросмотр в блоке Результат и при желании измените размер страницы, поля, шрифт или другие параметры в разделе Настройки.
  4. При необходимости измените Имя файла и нажмите кнопку скачивания. Текстовые форматы можно также сразу скопировать в буфер обмена, а для Jira, Slack и BBCode главная кнопка как раз копирует результат.

Конвертер открывается с примером квартального отчёта, в котором есть название в front matter, списки, таблица с числами, выровненными по правому краю, список задач, цитата, блок кода и сноска. Конвертируйте его в каждый формат, чтобы увидеть, как выглядят элементы.

Конвертер Markdown в PDF

PDF создаётся в вашем браузере с настоящим текстом, который можно выделять, а не как снимок страницы. Заголовки появляются как закладки на боковой панели программы для чтения PDF, ссылки остаются кликабельными, а ссылки на заголовки или сноски ведут к нужному месту внутри документа. Таблицы сохраняют выравнивание столбцов и повторяют строку заголовка на каждой странице, на которую переходят, вложенные списки нумеруются 1., a., i., как в Word, а у списков задач рисуются флажки. Блоки кода набираются моноширинным шрифтом на светло-сером фоне, поэтому отступы остаются в точности такими, как написаны.

В разделе Настройки вы выбираете Размер страницы (A4 или Letter, заранее выбран по языку браузера), Поля (узкие 1,27 см, обычные 2,54 см или широкие 3,81 см, то есть 0,5; 1 или 1,5 дюйма), Шрифт с засечками или без засечек, Размер шрифта и то, нужно ли печатать Номера страниц. Оглавление добавляет после названия список заголовков с номерами страниц.

Шрифты встроены в PDF, поэтому он выглядит одинаково на любом компьютере и принтере. Они охватывают латиницу, кириллицу, греческое письмо и вьетнамский алфавит, а также стрелки, математические знаки и символы вроде → ≤ ✓ ★. Китайская, японская, корейская, арабская, еврейская, тайская и индийские письменности, а также эмодзи в них не входят. Если документ их использует, конвертер называет эти символы, а кнопка скачивания меняется на Сохранить как PDF: она открывает диалог печати браузера, который использует шрифты вашей системы и выводит арабский текст и иврит справа налево. Выберите в качестве принтера «Сохранить как PDF», и размер страницы, поля и шрифт из раздела Настройки сохранятся.

Конвертация Markdown в Word (DOCX)

Файл Word получает настоящую структуру документа, а не просто текст, который так выглядит. Заголовки используют встроенные стили от «Заголовок 1» до «Заголовок 6», поэтому их показывает область навигации Word, а на вкладке «Ссылки» кнопка «Оглавление» создаёт оглавление в один щелчок. Списки становятся настоящими списками Word, которые сохраняют нумерацию при добавлении пунктов, каждый нумерованный список снова начинается с 1 (или с числа, которое вы написали), а пункты задач получают ☐ и ☒. Таблицы повторяют строку заголовка на каждой странице, сноски становятся настоящими сносками Word внизу страницы, а ссылки на заголовки ведут к ним.

Выберите размер страницы, поля, размер шрифта и один из стандартных шрифтов Calibri, Cambria, Arial или Times New Roman. Word показывает файл тем шрифтом, который установлен на открывшем его компьютере, поэтому предпросмотр здесь служит близким ориентиром, а не точной до пикселя копией. Файл .docx открывается в Microsoft Word, LibreOffice и других программах, которые читают формат Office Open XML. Чтобы перенести Markdown в Google Docs, загрузите .docx на Google Диск и откройте его в Google Docs или вставьте текст кнопкой «Копировать с форматированием» в редакторе Markdown.

Markdown в HTML

Полная страница со стилями даёт отдельный файл .html с собственной аккуратной таблицей стилей. Он работает без интернета, подстраивается под светлую или тёмную тему системы читателя и хорошо печатается. Только содержимое, для CMS даёт только элементы HTML (<h2>, <p>, <ul>, <table> и так далее) без стилей, готовые для вставки в WordPress, Ghost, сервис рассылок или ваш собственный шаблон. Переключайте предпросмотр между вкладками Просмотр и Код, чтобы увидеть обе стороны.

HTML соответствует CommonMark и GitHub Flavored Markdown (оба на английском). Заголовки получают атрибуты id, как на GitHub, поэтому ссылки вида #план-релиза продолжают работать, а у сносок есть ссылки обратно к месту, где на них сослались. Скрипты, обработчики событий и ссылки javascript: удаляются из любого HTML в исходном тексте, поэтому файл Markdown от другого человека не сможет подсунуть код на вашу страницу.

Markdown в обычный текст

Текст (TXT) удаляет синтаксис Markdown и сохраняет читаемую структуру: маркеры становятся «- », нумерованные пункты сохраняют номера, задачи показываются как [ ] и [x], цитаты начинаются с «> », таблицы выравниваются по столбцам, а сноски перечисляются в конце как [1], [2]. Сохранять адреса ссылок записывает URL в скобках после каждой ссылки, чтобы ничего не потерялось, когда текст попадёт в письмо, поле формы или систему, которая не понимает Markdown. Длина строки позволяет переносить длинные строки по 72 или 80 символов для писем в формате обычного текста.

Это удобно и для ответов чатов с ИИ, которые приходят в Markdown: преобразование в текст убирает звёздочки и решётки, прежде чем вы вставите ответ куда-то ещё.

Таблица Markdown в Excel и CSV

Excel (XLSX) и CSV берут из документа только таблицы, что удобно для таблиц из файлов README, документации или ответов чатов с ИИ. В Excel каждая таблица становится отдельным листом с названием по заголовку над ней. Числа сохраняются как настоящие числа, в том числе записанные с разделителем тысяч, как 1 240, и проценты, как 12 %, так что их можно сразу суммировать и сортировать, а значения вроде 007 или почтового индекса сохраняют ведущие нули и остаются текстом. Строка заголовка выделена полужирным и закреплена, а на каждом листе есть фильтр.

CSV записывает по одному файлу на таблицу, а несколько таблиц упаковываются в ZIP. В разделе Настройки вы выбираете Разделитель: Excel, настроенный на язык с десятичной запятой, например русский, немецкий или французский, ожидает точку с запятой, иначе вся строка попадает в один столбец. Совместимость с Excel (UTF-8 с BOM) позволяет Excel правильно прочитать кириллицу, буквы с диакритикой и другие символы. Копировать таблицы помещает таблицы в буфер обмена, чтобы вставить их в Excel или Google Таблицы без сохранения файла.

Markdown в Jira, Confluence, Slack и BBCode

Эти три формата представляют собой текст для приложений, которые не читают стандартный Markdown, поэтому главная кнопка копирует результат:

  • Jira / Confluence записывает вики-разметку: заголовки h2., *bold*, _italic_, блоки {code}, таблицы ||header||, ссылки [text|url] и списки # или *. Формат предназначен для Jira и Confluence Data Center или Server и для старых полей, которые ещё используют вики-разметку. Текущий редактор Jira Cloud сам читает Markdown, поэтому туда можно вставить исходный текст.
  • Slack записывает собственную разметку Slack: *bold*, _italic_, ~strikethrough~, код, цитаты и ссылки [text](url), списки в виде символов маркеров и таблицы в виде выровненных блоков кода, потому что в Slack нет таблиц. Включите в Slack настройку Format messages with markup в разделе Preferences, Advanced, чтобы видеть форматирование после отправки. Для ботов и вебхуков (формат API) записывает ссылки как <url|text> и экранирует &, < и >, как того требует Slack API.
  • BBCode использует теги, которые понимают phpBB, vBulletin, XenForo, SMF и MyBB: [b], [i], [u], [s], [url], [img], [quote], [list] и [code]. Заголовки становятся полужирными строками, так как размеры заголовков на разных форумах разные, а таблицы превращаются в выровненные блоки [code].

Markdown в EPUB для электронных книг и Kindle

EPUB собирает электронную книгу с титульной страницей, оглавлением и отдельной главой для каждого заголовка верхнего уровня. Если в документе только один заголовок первого уровня и он служит названием, главы начинаются с заголовков второго уровня; выбрать вариант можно в поле Начало новой главы в разделе Настройки. Сноски собираются в концевые сноски со ссылками обратно на текст, изображения с веб-адресом встраиваются в книгу, а название и автор из front matter попадают в сведения о книге.

Файлы проходят проверку EPUBCheck (на английском), официального валидатора EPUB, поэтому открываются в Apple Books, Kobo, Calibre и приложении Google Play Книги. Сервис Amazon Send to Kindle тоже принимает EPUB и преобразует его для вашего Kindle, а Kindle Direct Publishing принимает рукописи в EPUB, при этом обложка загружается отдельно.

Markdown в LaTeX

LaTeX создаёт полный документ article, который загружает только нужные пакеты, а с вариантом Только содержимое, для вставки в документ выдаёт лишь содержимое для статьи, которая у вас уже есть, например в Overleaf. Заголовки становятся \section и \subsection, списки становятся itemize и enumerate, таблицы становятся tabular с сохранённым выравниванием столбцов, код попадает в verbatim, сноски становятся настоящими командами \footnote, а ссылки используют \href. Символы, которые LaTeX воспринимает как команды, например %, $, &, # и _, экранируются. LaTeX не умеет загружать изображения из интернета, поэтому каждое изображение становится строкой \includegraphics с именем файла и исходным адресом в комментарии; скачайте изображение и положите его рядом с файлом .tex. Компилируйте с помощью pdfLaTeX, а для письменностей, отличных от латиницы, с помощью XeLaTeX или LuaLaTeX.

Конвертация нескольких файлов .md сразу

Откройте или перетащите несколько файлов, и под текстовым полем появится список. Изменить загружает файл в поле, чтобы его можно было проверить или исправить, Убрать исключает его из пакета, а Скачать все в ZIP конвертирует каждый файл в выбранный формат с одними и теми же настройками. Каждый файл сохраняет своё имя, так что notes.md становится notes.pdf. Файлы, которые не являются текстом, например изображения, пропускаются с уведомлением.

Front matter, изображения и имена файлов

Многие файлы Markdown начинаются с блока YAML front matter (на английском) между двумя строками ---, как в Jekyll, Hugo, Obsidian и других инструментах. Конвертер его не выводит. Его title становится названием документа в свойствах PDF и Word и в теге HTML <title>, а также предлагаемым именем файла; author становится автором. Без front matter файл получает имя по первому заголовку верхнего уровня.

Изображения с полным веб-адресом скачиваются вашим браузером и встраиваются в PDF и файл Word, если сервер, на котором они размещены, это разрешает (CORS). Изображения GIF, WebP и SVG при этом преобразуются в PNG.

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

Загружаются ли мои файлы Markdown на сервер?

Нет. Чтение файлов, создание документов PDF и Word и упаковка ZIP происходят в вашем браузере, поэтому личные заметки и внутренняя документация не покидают ваш компьютер. Конвертер запоминает только ваши настройки, например формат и размер страницы, но не текст.

Почему в моём PDF нет изображений?

Изображения, записанные как путь на вашем компьютере, например images/chart.png, веб-страница прочитать не может, поэтому они заменяются своим описанием. Используйте полный адрес https или сначала разместите изображение в интернете. Некоторые сайты также запрещают другим сайтам загружать свои изображения; в этом случае тоже используется описание, а конвертер сообщает, сколько изображений не удалось загрузить.

Можно ли конвертировать в PDF Markdown с китайским, японским или арабским текстом?

Да, через ваш браузер. Встроенные в PDF шрифты не содержат этих письменностей, поэтому для такого документа кнопка скачивания меняется на Сохранить как PDF и открывает диалог печати, где в качестве принтера нужно выбрать «Сохранить как PDF». Браузер использует шрифты вашей системы, текст по-прежнему можно выделять, а арабский текст и иврит выводятся справа налево. Word (DOCX) и HTML тоже сохраняют все символы.

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

Нет. Формулы между знаками доллара остаются обычным текстом, а блок Mermaid конвертируется как любой другой блок кода. Таблицы, списки задач, сноски, код и всё остальное из GitHub Flavored Markdown поддерживаются во всех форматах.

Можно ли конвертировать Word или Google Docs в Markdown?

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

Как конвертировать таблицу Markdown в Excel?

Вставьте Markdown с таблицей, выберите Excel (XLSX) и скачайте файл. Каждая таблица становится листом, в котором числа сохранены как числа. Если вам нужны только значения в уже открытой таблице, нажмите Копировать таблицы и вставьте их в Excel или Google Таблицы.

Почему Excel помещает всю строку CSV в один столбец?

Excel делит файл CSV на столбцы по разделителю элементов списка вашей системы. В языках с десятичной запятой, например в русском, немецком или французском, этим разделителем служит точка с запятой. Выберите Точка с запятой в поле Разделитель и скачайте файл снова. Если кириллица или буквы с диакритикой отображаются неправильно, оставьте включённым пункт Совместимость с Excel (UTF-8 с BOM).

Можно ли отправить EPUB на Kindle?

Да. Сервис Amazon Send to Kindle, будь то по электронной почте, в приложении Kindle или на сайте Send to Kindle, принимает файлы EPUB и преобразует их для библиотеки Kindle. Kindle Direct Publishing тоже принимает EPUB, если вы хотите опубликовать книгу.

Использует ли Jira Cloud до сих пор вики-разметку?

В текущем редакторе нет: он читает Markdown и превращает его в форматирование, когда вы вставляете или вводите текст. Формат Jira / Confluence предназначен для Jira и Confluence Data Center или Server и для старых полей, которые ещё показывают вики-разметку. В Jira Cloud вместо этого можно вставить исходный Markdown.

Можно ли открыть файл LaTeX в Overleaf?

Да. Создайте новый пустой проект, загрузите файл .tex или вставьте его содержимое и загрузите все изображения, которые в нём упоминаются. С вариантом Только содержимое, для вставки в документ вы получите только содержимое для проекта, в котором уже есть своя преамбула.

Как конвертировать Markdown в PDF или Word из командной строки?

Обычно для этого используют Pandoc (на английском): pandoc notes.md -o notes.docx сразу создаёт файл Word, а для вывода в PDF нужно ещё установить движок LaTeX. Эта страница не требует установки и сначала показывает предпросмотр, что удобнее для одного документа или небольшого пакета файлов.

Есть ли ограничение на размер файла или число страниц?

Каждый файл может содержать до 20 МБ текста, что намного больше любого обычного документа, и нет ни ограничения на число страниц, ни водяного знака. Очень длинные документы с большим количеством изображений создаются несколько секунд, потому что всю работу выполняет ваш собственный компьютер.

Чтобы сначала написать или отредактировать Markdown, используйте редактор Markdown с живым предпросмотром: его кнопка «Дополнительные настройки экспорта» открывает этот конвертер с уже вставленным текстом. Другие инструменты для текста собраны в категории Текст, например счётчик слов и символов и инструмент, чтобы сравнить два текста.

Я был бы признателен, если бы вы поделились этими страницами с друзьями, сохранили их в закладках или ссылались на них. Спасибо! 🙏