Конвертер 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 і звичайний текст працює прямо у вашому браузері: вставте текст або відкрийте файл .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 створює електронну книжку з титульною сторінкою, змістом і окремим розділом для кожного заголовка верхнього рівня. Якщо документ має лише один заголовок 1, який слугує назвою, розділи натомість починаються із заголовків 2; вибрати це можна параметром Поділ на розділи на панелі Параметри. Виноски перетворюються на кінцеві виноски з посиланнями назад до тексту, зображення з вебадресою вбудовуються, а назва й автор із front matter зʼявляються у відомостях про книжку.

Файли проходять перевірку офіційним валідатором EPUB EPUBCheck (англійською), тож вони відкриваються в Apple Books, Kobo, Google Play Книги та Calibre. Сервіс 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 або спершу розмістіть зображення в інтернеті. Деякі вебсайти також забороняють іншим сайтам завантажувати свої зображення, і тоді теж використовується опис, а конвертер повідомляє, скільки зображень не вдалося завантажити.

Чи можна перетворити Markdown із китайським, японським чи арабським текстом на PDF?

Так, через ваш браузер. Шрифти, вбудовані в 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-редактором із переглядом у реальному часі; його кнопка «Більше параметрів експорту» відкриває цей конвертер з уже вставленим текстом. Більше інструментів для тексту є в категорії Текст, наприклад лічильник слів і символів та інструмент, щоб порівняти два тексти.

Я буду вдячний, якщо ви поділитеся цими сторінками з друзями, збережете їх у закладках або посилання на них. Дякую! 🙏