Markdown převodník

Acrafto Team Text
Aktualizováno

Hlavička front matter na začátku se netiskne. Její titulek „Čtvrtletní zpráva“ se použije jako název dokumentu.

Výsledek
Čtvrtletní zpráva

Tento dokument ukazuje, co převodník zachová: nadpisy, seznamy, tabulky, kód, citace, odkazy a poznámky pod čarou.1

Hlavní body
  • Tržby vzrostly o 12 % oproti předchozímu čtvrtletí
  • V září nastoupili do týmu dva noví kolegové
  • Úplná čísla najdete na stránce projektu
Čísla
Měsíc Objednávky Změna
Červenec 1 240 +4 %
Srpen 1 310 +6 %
Září 1 395 +6 %
Další kroky
  1. Dokončit příručku pro nové kolegy
  2. Projít stránku s ceníkem
    • Porovnat ji se starou verzí
    • Požádat podporu o zpětnou vazbu
  3. Naplánovat další vydání
  • Shromáždit data
  • Odeslat zprávu

Čísla jsou zaokrouhlena na celé objednávky.

npm run build && npm run deploy

  1. Titulek pochází z hlavičky YAML front matter na začátku, která se netiskne. ↩︎

Nastavení

Převeďte Markdown do PDF, Wordu, HTML nebo prostého textu přímo ve svém prohlížeči: vložte text nebo otevřete soubor .md, vyberte formát a stáhněte výsledek. Převodník také změní tabulky z Markdownu na soubory Excel nebo CSV, vytvoří e-knihy EPUB a dokumenty LaTeX a přepíše Markdown pro Jiru, Confluence, Slack a fóra s BBCode. Náhled vedle textu ukazuje výsledek a mění se spolu s nastavením. Vaše soubory se nikam nenahrávají, nepotřebujete registraci, nepřidává se žádný vodoznak a počet stránek není omezený.

Jak převést soubor Markdown

  1. Vložte Markdown do levého pole, případně klikněte na Otevřít soubory a vyberte jeden či více souborů .md. Soubory můžete na převodník také přetáhnout.
  2. Zvolte formát v řádku Převést do. Ve skupině Dokumenty najdete PDF, Word (DOCX), EPUB, LaTeX, HTML a Text (TXT), ve skupině Tabulky formáty Excel (XLSX) a CSV a ve skupině Pro aplikace formáty Jira / Confluence, Slack a BBCode.
  3. Zkontrolujte náhled v části Výsledek a podle potřeby změňte velikost stránky, okraje, písmo nebo další volby v části Nastavení.
  4. Případně upravte Název souboru a klikněte na tlačítko pro stažení. Textové formáty můžete také rovnou zkopírovat do schránky a u formátů pro Jiru, Slack a BBCode je hlavním tlačítkem právě kopírování.

Po otevření je v převodníku ukázková čtvrtletní zpráva s titulkem ve front matter, seznamy, tabulkou s čísly zarovnanými doprava, seznamem úkolů, citací, blokem kódu a poznámkou pod čarou. Převeďte ji postupně do všech formátů a uvidíte, jak v nich jednotlivé prvky vypadají.

Převod Markdownu do PDF

PDF se vytváří ve vašem prohlížeči se skutečným textem, který jde označit, nikoli jako snímek stránky. Nadpisy se zobrazí jako záložky v postranním panelu čtečky PDF, odkazy zůstanou funkční a odkazy na nadpisy nebo poznámky pod čarou vedou na příslušné místo v dokumentu. Tabulky si zachovají zarovnání sloupců a na každé stránce, přes kterou zasahují, zopakují řádek záhlaví. Vnořené seznamy se číslují 1., a., i. jako ve Wordu a seznamy úkolů dostanou nakreslená zaškrtávací políčka. Bloky kódu používají neproporcionální písmo na světle šedém pozadí, takže odsazení zůstane přesně tak, jak bylo napsáno.

V části Nastavení zvolíte Velikost stránky (A4 nebo Letter, předvolená podle jazyka prohlížeče), Okraje (úzké 1,27 cm, normální 2,54 cm nebo široké 3,81 cm, tedy 0,5 palce, 1 palec nebo 1,5 palce), patkové nebo bezpatkové Písmo, Velikost písma a to, zda se mají tisknout Čísla stránek. Obsah přidá za titulek seznam nadpisů s čísly stránek.

Písma jsou uložená přímo v PDF, takže dokument vypadá stejně na každém počítači i tiskárně. Pokrývají latinku, cyrilici, řecké písmo a vietnamštinu, k tomu šipky, matematická znaménka a symboly jako → ≤ ✓ ★. Čínské, japonské, korejské, arabské, hebrejské, thajské a indické písmo ani emoji v nich nejsou. Když je dokument obsahuje, převodník tyto znaky vyjmenuje a tlačítko pro stažení se změní na Uložit jako PDF: otevře dialog tisku prohlížeče, který použije písma vašeho systému a arabštinu i hebrejštinu zobrazí zprava doleva. Jako tiskárnu zvolte Uložit jako PDF a velikost stránky, okraje i písmo z Nastavení zůstanou zachované.

Převod Markdownu do Wordu (DOCX)

Soubor Wordu má skutečnou strukturu dokumentu, nejen text, který tak vypadá. Nadpisy používají vestavěné styly Nadpis 1 až Nadpis 6, takže je navigační podokno Wordu vypíše a tlačítko Obsah na kartě Reference z nich jedním kliknutím sestaví obsah. Seznamy jsou opravdové seznamy Wordu, které při přidávání položek udrží číslování. Každý číslovaný seznam začíná znovu od 1 (nebo od čísla, které jste napsali) a úkoly dostanou ☐ a ☒. Tabulky opakují řádek záhlaví na každé stránce, z poznámek pod čarou se stanou skutečné poznámky pod čarou Wordu v dolní části stránky a odkazy na nadpisy na ně po kliknutí přejdou.

Zvolte velikost stránky, okraje, velikost písma a jedno ze standardních písem Calibri, Cambria, Arial nebo Times New Roman. Word zobrazí soubor písmem nainstalovaným v počítači, na kterém se otevře, takže náhled zde je spíš věrným vodítkem než přesnou kopií na pixel. Soubor .docx otevřete v Microsoft Wordu, LibreOffice a dalších programech, které čtou formát Office Open XML. Chcete-li dostat Markdown do Google Docs, nahrajte soubor .docx na Disk Google a otevřete ho v Google Docs, nebo text vložte pomocí Kopírovat s formátováním z Markdown editoru.

Markdown do HTML

Celá stránka se styly vytvoří samostatný soubor .html s vlastní čistou šablonou stylů. Funguje offline, řídí se světlým nebo tmavým režimem systému čtenáře a dobře se tiskne. Jen tělo stránky pro CMS vytvoří jen prvky HTML (<h2>, <p>, <ul>, <table> a další) bez jakýchkoli stylů, připravené k vložení do WordPressu, Ghostu, nástroje na newslettery nebo vlastní šablony. Přepínáním náhledu mezi Vykreslené a Kód uvidíte obě podoby.

HTML se řídí specifikacemi CommonMark a GitHub Flavored Markdown (obojí anglicky). Nadpisy dostávají atributy id jako na GitHubu, takže odkazy jako #plán-vydání fungují dál, a poznámky pod čarou mají odkazy zpět na místo, kde se na ně text odkazuje. Skripty, obsluhy událostí a odkazy javascript: se z veškerého HTML ve zdrojovém textu odstraní, takže soubor Markdown od někoho jiného nemůže do vaší stránky propašovat kód.

Markdown do prostého textu

Text (TXT) odstraní syntaxi Markdownu a zachová čitelnou strukturu: odrážky se změní na „- “, číslované položky si ponechají čísla, úkoly se zobrazí jako [ ] a [x], citace začínají „> “, tabulky jsou zarovnané do sloupců a poznámky pod čarou se vypíšou na konci jako [1], [2]. Zachovat adresy odkazů zapíše za každý odkaz jeho URL v závorce, takže se nic neztratí, když text skončí v e-mailu, ve formulářovém poli nebo v systému, který Markdownu nerozumí. Délka řádku může zalomit dlouhé řádky na 72 nebo 80 znaků pro e-maily v prostém textu.

Hodí se to i pro odpovědi AI chatbotů, které přicházejí v Markdownu: převodem na text zmizí hvězdičky a mřížky dřív, než odpověď vložíte jinam.

Tabulka z Markdownu do Excelu a CSV

Excel (XLSX) a CSV vezmou z dokumentu jen tabulky, což se hodí u tabulek v souborech README, v dokumentaci nebo v odpovědích AI chatbotů. V Excelu se každá tabulka stane samostatným listem pojmenovaným podle nadpisu nad ní. Čísla se ukládají jako skutečná čísla, včetně čísel s oddělovačem tisíců, jako je 1 240, a procent, jako je 12 %, takže je můžete hned sčítat a řadit. Hodnoty jako 007 nebo PSČ si naopak ponechají úvodní nuly a zůstanou textem. Řádek záhlaví je tučný a ukotvený a každý list dostane filtr.

CSV zapíše jeden soubor na každou tabulku a více tabulek zabalí do archivu ZIP. V části Nastavení zvolíte Oddělovač: Excel nastavený na jazyk s desetinnou čárkou, například na češtinu, němčinu nebo francouzštinu, očekává středník, jinak skončí celý řádek v jednom sloupci. Kompatibilní s Excelem (UTF-8 s BOM) zajistí, že Excel správně přečte diakritiku a další znaky. Kopírovat tabulky uloží tabulky do schránky, takže je vložíte do Excelu nebo Tabulek Google bez ukládání souboru.

Markdown pro Jiru, Confluence, Slack a BBCode

Tyto tři formáty jsou text pro aplikace, které standardní Markdown nečtou, proto hlavní tlačítko výsledek zkopíruje:

  • Jira / Confluence zapisuje wiki syntaxi: nadpisy h2., *bold*, _italic_, bloky {code}, tabulky ||header||, odkazy [text|url] a seznamy s # nebo *. Je určený pro Jiru a Confluence ve verzi Data Center nebo Server a pro starší pole, která wiki syntaxi stále používají. Současný editor v Jira Cloud čte Markdown sám, takže tam můžete vložit původní text.
  • Slack zapisuje vlastní syntaxi Slacku: *bold*, _italic_, ~strikethrough~, kód, citace a odkazy [text](url), seznamy převádí na řádky se znakem odrážky a tabulky na zarovnané bloky kódu, protože Slack tabulky nemá. Aby se formátování po odeslání zobrazilo, zapněte ve Slacku v Preferences, Advanced volbu Format messages with markup. Pro boty a webhooky (formát API) zapisuje odkazy jako <url|text> a převádí &, < a > na entity, jak to Slack API očekává.
  • BBCode používá značky, kterým rozumí phpBB, vBulletin, XenForo, SMF i MyBB: [b], [i], [u], [s], [url], [img], [quote], [list] a [code]. Z nadpisů se stanou tučné řádky, protože velikosti nadpisů se fórum od fóra liší, a tabulky se změní na zarovnané bloky [code].

Markdown do EPUB pro čtečky a Kindle

EPUB vytvoří e-knihu s titulní stránkou, obsahem a jednou kapitolou pro každý nadpis nejvyšší úrovně. Když má dokument jediný nadpis první úrovně, který slouží jako titulek, začínají kapitoly až u nadpisů druhé úrovně. Kde mají kapitoly začínat, zvolíte v části Nastavení v poli Kapitoly podle. Poznámky pod čarou se shromáždí jako vysvětlivky s odkazy zpět do textu, obrázky s webovou adresou se vloží do knihy a titulek a autor z front matter se objeví v údajích o knize.

Soubory projdou kontrolou EPUBCheck (anglicky), což je oficiální validátor formátu EPUB, takže se otevřou v Apple Books, Kobo, Knihách Google Play a Calibre. Služba Send to Kindle od Amazonu EPUB také přijímá a převede ho pro váš Kindle. Kindle Direct Publishing přijímá rukopisy ve formátu EPUB, obálka se nahrává zvlášť.

Markdown do LaTeXu

LaTeX vytvoří úplný dokument třídy article, který načítá jen potřebné balíčky. S volbou Jen obsah k vložení do dokumentu dostanete pouze obsah pro dokument, který už máte rozpracovaný, například v Overleafu. Nadpisy se změní na \section a \subsection, seznamy na itemize a enumerate, tabulky na tabular se zachovaným zarovnáním sloupců, kód se vloží do verbatim, poznámky pod čarou se stanou skutečnými příkazy \footnote a odkazy používají \href. Znaky, které LaTeX chápe jako příkazy, například %, $, &, # a _, se escapují. LaTeX neumí načíst obrázky z webu, proto se každý obrázek změní na řádek \includegraphics s názvem souboru a původní adresou v komentáři. Obrázek stáhněte do stejné složky jako soubor .tex. Kompilujte pomocí pdfLaTeX, pro jiná písma než latinku pomocí XeLaTeX nebo LuaLaTeX.

Převod více souborů .md najednou

Otevřete nebo přetáhněte několik souborů a pod textovým polem se objeví jejich seznam. Upravit načte soubor do pole, abyste ho mohli zkontrolovat nebo opravit, Odebrat ho z dávky vyřadí a Stáhnout vše jako ZIP převede všechny soubory do zvoleného formátu se stejným nastavením. Každý soubor si ponechá svůj název, takže z notes.md vznikne notes.pdf. Soubory, které nejsou textové, například obrázky, se s upozorněním přeskočí.

Front matter, obrázky a názvy souborů

Mnoho souborů Markdown začíná blokem YAML front matter (anglicky) mezi dvěma řádky ---, jaký používají Jekyll, Hugo, Obsidian a další nástroje. Převodník ho netiskne. Hodnota title se stane názvem dokumentu ve vlastnostech PDF a Wordu i ve značce <title> v HTML a zároveň navrženým názvem souboru, z hodnoty author se stane autor. Bez front matter dá souboru název první nadpis nejvyšší úrovně.

Obrázky s úplnou webovou adresou stáhne váš prohlížeč a vloží je do PDF a do souboru Wordu, pokud to server, na kterém jsou uložené, dovolí (CORS, anglicky). Obrázky GIF, WebP a SVG se přitom převedou na PNG.

Časté otázky

Nahrávají se moje soubory Markdown na server?

Ne. Čtení souborů, vytváření dokumentů PDF a Word i balení do archivu ZIP probíhají ve vašem prohlížeči, takže soukromé poznámky a interní dokumentace nikdy neopustí váš počítač. Převodník si pamatuje jen vaše nastavení, například formát a velikost stránky, ne text.

Proč v mém PDF chybějí obrázky?

Obrázky zapsané jako cesta ve vašem počítači, například images/chart.png, webová stránka přečíst nemůže, a proto je nahradí jejich popis. Použijte úplnou adresu https, případně obrázek nejdřív nahrajte na internet. Některé weby také jiným stránkám načítání svých obrázků blokují. I v tom případě se použije popis a převodník vás upozorní, kolik obrázků se nepodařilo načíst.

Dá se do PDF převést Markdown s čínským, japonským nebo arabským textem?

Ano, pomocí tisku z prohlížeče. Písma vestavěná do PDF tyto znaky neobsahují, proto se u takového dokumentu tlačítko pro stažení změní na Uložit jako PDF a otevře dialog tisku, kde jako tiskárnu zvolíte Uložit jako PDF. Prohlížeč použije písma vašeho systému, text zůstane označitelný a arabština i hebrejština se zobrazí zprava doleva. Word (DOCX) a HTML také zachovají všechny znaky.

Podporuje převodník matematické vzorce v LaTeXu nebo diagramy Mermaid?

Ne. Vzorce zapsané mezi znaky dolaru zůstanou prostým textem a blok Mermaid se převede jako každý jiný blok kódu. Tabulky, seznamy úkolů, poznámky pod čarou, kód a vše ostatní z GitHub Flavored Markdown jsou podporovány ve všech formátech.

Dá se Word nebo Google Docs převést na Markdown?

Ano, pomocí Markdown editoru: vložte do něj text zkopírovaný z Wordu, Google Docs nebo z webové stránky a jeho formátování se změní na Markdown, včetně nadpisů, seznamů, odkazů a tabulek. Převod PDF zpět na Markdown podporovaný není, protože PDF ukládá text rozmístěný na stránce, a ne nadpisy, seznamy a tabulky.

Jak převést tabulku z Markdownu do Excelu?

Vložte Markdown s tabulkou, zvolte Excel (XLSX) a stáhněte soubor. Každá tabulka se stane listem s čísly uloženými jako čísla. Pokud potřebujete hodnoty jen přenést do sešitu, který už máte otevřený, klikněte na Kopírovat tabulky a vložte je do Excelu nebo Tabulek Google.

Proč Excel zobrazí celý řádek CSV v jednom sloupci?

Excel rozděluje soubor CSV podle oddělovače seznamu nastaveného v systému. V jazycích, které používají desetinnou čárku, například v češtině, němčině nebo francouzštině, je tímto oddělovačem středník. Zvolte Středník v poli Oddělovač a stáhněte soubor znovu. Pokud se diakritika zobrazuje špatně, nechte zapnuté Kompatibilní s Excelem (UTF-8 s BOM).

Můžu poslat EPUB do svého Kindlu?

Ano. Služba Send to Kindle od Amazonu přijímá soubory EPUB e-mailem, v aplikaci Kindle i na webu Send to Kindle a převádí je do knihovny Kindle. Kindle Direct Publishing přijímá EPUB také, pokud chcete knihu vydat.

Používá Jira Cloud ještě wiki syntaxi?

Ve svém současném editoru ne. Ten čte Markdown a při vkládání nebo psaní ho mění na formátování. Formát Jira / Confluence je určený pro Jiru a Confluence ve verzi Data Center nebo Server a pro starší pole, která wiki syntaxi stále zobrazují. V Jira Cloud můžete místo toho vložit původní Markdown.

Dá se soubor LaTeX otevřít v Overleafu?

Ano. Vytvořte nový prázdný projekt, nahrajte soubor .tex nebo vložte jeho obsah a nahrajte i obrázky, na které odkazuje. S volbou Jen obsah k vložení do dokumentu dostanete jen obsah pro projekt, který už má vlastní preambuli.

Jak převést Markdown do PDF nebo Wordu z příkazové řádky?

Obvyklým nástrojem je Pandoc (anglicky): pandoc notes.md -o notes.docx vytvoří soubor Wordu hned, zatímco výstup do PDF potřebuje navíc nainstalovaný LaTeX. Tato stránka nevyžaduje žádnou instalaci a nejdřív vám ukáže náhled, což je jednodušší pro jeden dokument nebo několik souborů najednou.

Je omezená velikost souboru nebo počet stránek?

Každý soubor může mít až 20 MB textu, což je mnohem víc než jakýkoli běžný dokument. Počet stránek omezený není a nepřidává se žádný vodoznak. Velmi dlouhé dokumenty s mnoha obrázky se vytvářejí několik sekund, protože veškerou práci dělá váš vlastní počítač.

Chcete-li Markdown nejdřív napsat nebo upravit, použijte Markdown editor s živým náhledem. Odkaz Další možnosti exportu v editoru otevře tento převodník a rovnou do něj vloží váš text. Další nástroje pro práci s textem najdete v kategorii Text, například počítadlo slov a znaků nebo nástroj na porovnání dvou textů.

Uvítal bych, kdybyste tyto stránky sdíleli s přáteli, uložili si je do záložek nebo na ně odkazovali. Děkuji! 🙏