Markdown конвертор

Acrafto Team Текст
Актуализирано

Блокът front matter в началото не се отпечатва. Заглавието от него „Тримесечен отчет“ се използва като заглавие на документа.

Резултат
Тримесечен отчет

Този документ показва какво запазва конверторът: заглавия, списъци, таблици, код, цитати, връзки и бележки под линия.1

Акценти
  • Приходите нараснаха с 12% спрямо предходното тримесечие
  • През септември към екипа се присъединиха двама нови колеги
  • Страницата на проекта съдържа всички числа
Числа
Месец Поръчки Промяна
Юли 1240 +4%
Август 1310 +6%
Септември 1395 +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 Drive и го отворете с 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 всяка таблица става отделен лист, наречен по заглавието над нея. Числата като 1240 или 12 500 (с интервал между хилядите) и процентите като 12% се записват като истински числа, така че можете веднага да ги сумирате и сортирате, а стойности като 007 или пощенски код запазват водещите си нули като текст. Заглавният ред е получер и фиксиран, а всеки лист получава филтър.

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

Markdown в Jira, Confluence, Slack и BBCode

Тези три формата са текст за приложения, които не четат стандартен Markdown, затова основният бутон копира резултата:

  • Jira / Confluence записва уики синтаксис (wiki markup): заглавия h2., *bold*, _italic_, блокове {code}, таблици ||header||, връзки [text|url] и списъци с # или *. Той е предназначен за Jira и Confluence Data Center или Server и за по-старите полета, които все още използват уики синтаксис. Текущият редактор в Jira Cloud сам чете Markdown, така че там можете да поставите оригиналния текст.
  • Slack записва собствения синтаксис на Slack: *bold*, _italic_, ~strikethrough~, код, цитати и връзки [text](url), като списъците са със символи за водещи точки, а таблиците са подравнени блокове с код, защото Slack няма таблици. Включете Format messages with markup в Preferences, Advanced в Slack, за да виждате форматирането след изпращане. За ботове и уебхукове (формат 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 се появяват в данните на книгата.

Файловете преминават проверката на EPUBCheck (на английски), официалния валидатор на EPUB, така че се отварят в Apple Books, Kobo, Google Play Книги и Calibre. Услугата Send to Kindle на Amazon също приема 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 Sheets.

Защо Excel слага целия ред от CSV файла в една колона?

Excel разделя CSV файла по разделителя за списъци на системата ви. В езиците, които пишат десетичните дроби със запетая, като български, немски, френски или чешки, този разделител е точка и запетая. Изберете Точка и запетая в Разделител и изтеглете отново. Ако кирилицата или буквите с диакритика изглеждат грешно, оставете опцията Съвместим с Excel (UTF-8 с BOM) включена.

Мога ли да изпратя EPUB файла на моя Kindle?

Да. Услугата Send to Kindle на Amazon, по имейл, в приложението 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 MB текст, което е много повече от всеки нормален документ, и няма ограничение за броя на страниците, нито воден знак. Създаването на много дълги документи с много изображения може да отнеме няколко секунди, защото цялата работа се извършва от собствения ви компютър.

За да напишете или редактирате Markdown преди конвертирането, използвайте Markdown редактора с преглед на живо; връзката Още опции за експорт в редактора отваря този конвертор заедно с текста. Още инструменти за текст има в категорията Текст, например брояча на символи и думи и инструмента за сравняване на два текста.

Бих се радвал, ако споделите тези страници с приятели, ги запазите в отметки или ги свържете. Благодаря! 🙏