Markdown prevodník
Hlavička front matter na začiatku sa netlačí. Jej titulok „Štvrťročná správa“ sa použije ako názov dokumentu.
Tento dokument ukazuje, čo prevodník zachová: nadpisy, zoznamy, tabuľky, kód, citácie, odkazy a poznámky pod čiarou.1
- Tržby oproti predchádzajúcemu štvrťroku vzrástli o 12 %
- V septembri sa k tímu pridali dvaja noví kolegovia
- Všetky čísla nájdete na stránke projektu
| Mesiac | Objednávky | Zmena |
|---|---|---|
| Júl | 1 240 | +4 % |
| August | 1 310 | +6 % |
| September | 1 395 | +6 % |
- Dokončiť príručku pre nových kolegov
- Skontrolovať stránku s cenami
- Porovnať so starou verziou
- Požiadať podporu o spätnú väzbu
- Naplánovať ďalšie vydanie
- Zozbierať údaje
- Odoslať správu
Čísla sú zaokrúhlené na celé objednávky.
npm run build && npm run deploy
-
Titulok pochádza z hlavičky YAML front matter na začiatku, ktorá sa netlačí. ↩︎
Možnosti
Previeďte Markdown na PDF, Word, HTML alebo obyčajný text týmto Markdown prevodníkom, ktorý beží priamo vo vašom prehliadači: vložte text alebo otvorte súbor .md, vyberte formát a stiahnite výsledok. Prevodník zmení aj tabuľky z Markdownu na súbory Excel alebo CSV, vytvorí e-knihy EPUB a dokumenty LaTeX a prepíše Markdown pre Jira, Confluence, Slack a BBCode vo fórach. Náhľad vedľa textu ukazuje výsledok, kým upravujete nastavenia. Vaše súbory sa nikam nenahrávajú, netreba sa registrovať a nie je tu vodoznak ani limit strán.
Ako previesť súbor Markdown
- Vložte Markdown do ľavého poľa alebo kliknite na Otvoriť súbory a vyberte jeden alebo viac súborov .md. Súbory môžete na prevodník aj presunúť.
- Vyberte formát v časti Previesť na. Dokumenty sú PDF, Word (DOCX), EPUB, LaTeX, HTML a Text (TXT), Tabuľky sú Excel (XLSX) a CSV a Pre aplikácie sú Jira / Confluence, Slack a BBCode.
- Skontrolujte náhľad v časti Výsledok a podľa potreby zmeňte veľkosť strany, okraje, písmo alebo iné nastavenia v časti Možnosti.
- Ak treba, upravte Názov súboru a kliknite na tlačidlo sťahovania. Textové formáty môžete skopírovať aj priamo do schránky a pri Jira, Slacku a BBCode je hlavným tlačidlom kopírovanie.
Prevodník sa otvorí s ukážkovou štvrťročnou správou, ktorá má titulok v hlavičke front matter, zoznamy, tabuľku s číslami zarovnanými doprava, zoznam úloh, citáciu, blok kódu a poznámku pod čiarou. Preveďte ju do každého formátu a uvidíte, ako jednotlivé prvky dopadnú.
Prevodník Markdown na PDF
PDF sa vytvára vo vašom prehliadači so skutočným textom, ktorý sa dá označiť, nie ako snímka stránky. Nadpisy sa zobrazia ako záložky v bočnom paneli čítačky PDF, odkazy zostanú klikateľné a odkazy na nadpisy alebo poznámky pod čiarou skáču v rámci dokumentu. Tabuľky si zachovajú zarovnanie stĺpcov a na každej strane, na ktorú zasahujú, zopakujú riadok hlavičky, vnorené zoznamy sa číslujú 1., a., i. ako vo Worde a zoznamy úloh dostanú nakreslené začiarkavacie políčka. Bloky kódu používajú písmo s pevnou šírkou znakov na svetlosivom pozadí, takže odsadenie zostane presne tak, ako je napísané.
V časti Možnosti zvolíte Veľkosť strany (A4 alebo Letter, predvolená podľa jazyka prehliadača), Okraje (úzke 1,27 cm, normálne 2,54 cm alebo široké 3,81 cm, teda 0,5 palca, 1 palec alebo 1,5 palca), Písmo (pätkové alebo bezpätkové), Veľkosť písma a to, či sa majú tlačiť Čísla strán. Obsah pridá za titulok zoznam nadpisov s číslami strán.
Písma sú vložené priamo v PDF, takže súbor vyzerá rovnako na každom počítači a tlačiarni. Pokrývajú latinku, cyriliku, grécke písmo a vietnamčinu, k tomu šípky, matematické znaky a symboly ako → ≤ ✓ ★. Čínske, japonské, kórejské, arabské, hebrejské a thajské písmo, indické písma a emoji v nich nie sú. Keď ich dokument používa, prevodník tieto znaky vypíše a tlačidlo sťahovania sa zmení na Uložiť ako PDF: otvorí dialóg tlače vášho prehliadača, ktorý používa písma vášho systému a arabčinu aj hebrejčinu píše sprava doľava. Ako tlačiareň vyberte Uložiť ako PDF a veľkosť strany, okraje a písmo nastavené v časti Možnosti zostanú zachované.
Prevod Markdownu do Wordu (DOCX)
Súbor Word má skutočnú štruktúru dokumentu, nie iba text, ktorý tak vyzerá. Nadpisy používajú vstavané štýly Nadpis 1 až Nadpis 6, takže ich Word zobrazí na navigačnej table a cez Referencie, Obsah vytvoríte stránku s obsahom jedným kliknutím. Zoznamy sú skutočné zoznamy Wordu, ktoré po pridaní položiek zachovajú číslovanie, každý číslovaný zoznam začína znova od 1 (alebo od čísla, ktoré ste napísali) a úlohy dostanú ☐ a ☒. Tabuľky opakujú riadok hlavičky na každej strane, poznámky pod čiarou sa stanú skutočnými poznámkami pod čiarou Wordu v dolnej časti strany a odkazy na nadpisy na ne skáču.
Vyberte veľkosť strany, okraje, veľkosť písma a jedno zo štandardných písiem Calibri, Cambria, Arial alebo Times New Roman. Word zobrazí súbor písmom nainštalovaným v počítači, ktorý ho otvára, takže náhľad tu slúži ako blízka predloha, nie ako kópia presná na pixel. Súbor .docx sa otvorí v programe Microsoft Word, v LibreOffice a ďalších programoch, ktoré čítajú formát Office Open XML (v angličtine). Ak chcete Markdown dostať do Google Docs, nahrajte súbor .docx na Google Drive a otvorte ho v Google Docs, alebo text vložte pomocou kopírovania s formátovaním z Markdown editora.
Markdown na HTML
Celá stránka so štýlmi vám dá samostatný súbor .html s vlastným čistým štýlom. Funguje offline, riadi sa svetlým alebo tmavým režimom systému čitateľa a dobre sa tlačí. Len telo, pre CMS vám dá iba prvky HTML (<h2>, <p>, <ul>, <table> a podobne) bez štýlov, pripravené na vloženie do WordPressu, Ghostu, nástroja na newslettre alebo do vlastnej šablóny. Náhľad prepínajte medzi zobrazeniami Vykreslené a Kód a uvidíte obe strany.
HTML sa riadi špecifikáciami CommonMark a GitHub Flavored Markdown (obe v angličtine). Nadpisy dostanú atribúty id ako na GitHube, takže odkazy ako #plán-vydania fungujú ďalej, a poznámky pod čiarou majú odkazy späť na miesto, kde boli citované. Skripty, obsluhy udalostí a odkazy javascript: sa zo surového HTML v zdroji odstraňujú, takže súbor Markdown od niekoho iného nemôže do vašej stránky prepašovať kód.
Markdown na obyčajný text
Text (TXT) odstráni syntax Markdownu a štruktúru ponechá čitateľnú: odrážky sa zmenia na „- “, číslované položky si zachovajú čísla, úlohy sa zobrazia ako [ ] a [x], citácie začínajú „> “, tabuľky sú zarovnané do stĺpcov a poznámky pod čiarou sú vypísané na konci ako [1], [2]. Ponechať adresy odkazov zapíše za každý odkaz jeho URL v zátvorkách, takže sa nič nestratí, keď text putuje do e-mailu, formulárového poľa alebo systému, ktorý Markdown nepozná. Dĺžka riadka môže zalamovať dlhé riadky na 72 alebo 80 znakov pre e-maily v obyčajnom texte.
To sa hodí aj na odpovede AI chatbotov, ktoré prichádzajú v Markdowne: prevodom na text odstránite hviezdičky a mriežky skôr, než ich vložíte inam.
Tabuľka z Markdownu do Excelu a CSV
Excel (XLSX) a CSV vyberú z dokumentu iba tabuľky, čo sa hodí pri tabuľkách v súboroch README, v dokumentácii alebo v odpovediach AI chatbotov. V Exceli sa z každej tabuľky stane samostatný hárok pomenovaný podľa nadpisu nad ňou. Čísla sa uložia ako skutočné čísla, vrátane zápisu s oddeľovačom tisícov ako 1 240 a percent ako 12 %, takže ich môžete hneď sčítať a zoradiť, zatiaľ čo hodnoty ako 007 alebo PSČ si nuly na začiatku zachovajú ako text. Riadok hlavičky je tučný a ukotvený a každý hárok dostane filter.
CSV zapíše jeden súbor na každú tabuľku a viac tabuliek zabalí do ZIP. V časti Možnosti vyberiete Oddeľovač: Excel nastavený na jazyk s desatinnou čiarkou, napríklad na slovenčinu, nemčinu alebo francúzštinu, očakáva bodkočiarku, inak celý riadok skončí v jednom stĺpci. Kompatibilné s Excelom (UTF-8 s BOM) zabezpečí, že Excel správne prečíta diakritiku a ďalšie znaky. Kopírovať tabuľky skopíruje tabuľky do schránky, takže ich môžete vložiť do Excelu alebo Google Sheets bez ukladania súboru.
Markdown do Jira, Confluence, Slacku a BBCode
Tieto tri formáty sú text pre aplikácie, ktoré nečítajú štandardný Markdown, preto hlavné tlačidlo výsledok skopíruje:
- Jira / Confluence zapisuje wiki markup: nadpisy
h2.,*bold*,_italic_, bloky{code}, tabuľky||header||, odkazy[text|url]a zoznamy#alebo*. Je určený pre Jira a Confluence Data Center alebo Server a pre staršie polia, ktoré stále používajú wiki markup. Aktuálny editor v Jira Cloud číta Markdown sám, takže tam môžete vložiť pôvodný text. - Slack zapisuje vlastnú syntax Slacku:
*bold*,_italic_,~strikethrough~, kód, citácie a odkazy[text](url), zoznamy so znakmi odrážok a tabuľky ako zarovnané bloky kódu, pretože Slack tabuľky nemá. Ak chcete formátovanie vidieť po odoslaní, zapnite v Slacku Format messages with markup v nastaveniach Preferences, Advanced. Pre botov a webhooky (formát API) zapisuje odkazy ako<url|text>a znaky&,<a>nahradí entitami, ako to očakáva Slack API. - BBCode používa značky, ktorým rozumejú phpBB, vBulletin, XenForo, SMF aj MyBB:
[b],[i],[u],[s],[url],[img],[quote],[list]a[code]. Nadpisy sa zmenia na tučné riadky, keďže veľkosti nadpisov sa na každom fóre líšia, a tabuľky na zarovnané bloky[code].
Markdown do EPUB pre čítačky a Kindle
EPUB vytvorí e-knihu s titulnou stranou, obsahom a jednou kapitolou pre každý nadpis najvyššej úrovne. Keď má dokument jediný nadpis 1. úrovne použitý ako titulok, kapitoly začínajú pri nadpisoch 2. úrovne; v časti Možnosti to môžete zmeniť voľbou Delenie na kapitoly. Poznámky pod čiarou sa zhromaždia ako poznámky na konci knihy s odkazmi späť do textu, obrázky s webovou adresou sa vložia do knihy a titulok a autor z hlavičky front matter sa zobrazia v údajoch knihy.
Súbory prejdú kontrolou EPUBCheck (v angličtine), oficiálnym validátorom EPUB, takže sa otvoria v Apple Books, Kobo, Knihách Google Play a Calibre. Služba Send to Kindle od Amazonu tiež prijíma EPUB a prevedie ho pre váš Kindle a Kindle Direct Publishing prijíma rukopisy vo formáte EPUB, pričom obálka sa nahráva samostatne.
Markdown do LaTeXu
LaTeX vytvorí úplný dokument article, ktorý načíta iba potrebné balíky, alebo s voľbou Len telo, na vloženie do dokumentu iba obsah pre článok, ktorý už máte, napríklad v Overleaf. Nadpisy sa zmenia na \section a \subsection, zoznamy na itemize a enumerate, tabuľky na tabular so zachovaným zarovnaním stĺpcov, kód pôjde do verbatim, poznámky pod čiarou sa stanú skutočnými príkazmi \footnote a odkazy používajú \href. Znaky, ktoré LaTeX považuje za príkazy, ako %, $, &, # a _, sa escapujú. LaTeX nevie načítať obrázky z webu, takže každý obrázok sa zmení na riadok \includegraphics s názvom súboru a pôvodnou adresou v komentári; obrázok stiahnite do rovnakého priečinka ako súbor .tex. Kompilujte pomocou pdfLaTeX, pre iné písma než latinku pomocou XeLaTeX alebo LuaLaTeX.
Prevod viacerých súborov .md naraz
Otvorte alebo presuňte viac súborov a pod textovým poľom sa zobrazí ich zoznam. Upraviť načíta súbor do poľa, aby ste ho mohli skontrolovať alebo opraviť, Odstrániť ho vyradí z dávky a Stiahnuť všetko ako ZIP prevedie každý súbor do zvoleného formátu s rovnakými nastaveniami. Každý súbor si zachová názov, takže z notes.md bude notes.pdf. Súbory, ktoré nie sú textové, napríklad obrázky, sa preskočia s upozornením.
Front matter, obrázky a názvy súborov
Mnohé súbory Markdown začínajú blokom YAML front matter (v angličtine) medzi dvoma riadkami ---, aký používajú Jekyll, Hugo, Obsidian a ďalšie nástroje. Prevodník ho netlačí. Jeho title sa stane titulkom dokumentu vo vlastnostiach PDF a Wordu a v HTML <title> a zároveň navrhovaným názvom súboru; author sa stane autorom. Bez front matter dá súboru názov prvý nadpis najvyššej úrovne.
Obrázky s úplnou webovou adresou stiahne váš prehliadač a vloží ich do PDF a súboru Word, pokiaľ to server, na ktorom sú uložené, dovolí (CORS, v angličtine). Obrázky GIF, WebP a SVG sa cestou prevedú na PNG.
Často kladené otázky
Nahrávajú sa moje súbory Markdown na server?
Nie. Čítanie súborov, vytváranie dokumentov PDF a Word aj balenie do ZIP prebieha vo vašom prehliadači, takže súkromné poznámky a interná dokumentácia nikdy neopustia váš počítač. Prevodník si pamätá iba vaše nastavenia, napríklad formát a veľkosť strany, nie text.
Prečo v mojom PDF chýbajú obrázky?
Obrázky zapísané ako cesta vo vašom počítači, napríklad images/chart.png, webová stránka načítať nemôže, preto ich nahradí ich popis. Použite úplnú adresu https alebo obrázok najprv zverejnite online. Niektoré weby tiež iným stránkam nedovolia načítať svoje obrázky; aj vtedy sa použije popis a prevodník vám povie, koľko obrázkov sa nepodarilo načítať.
Dá sa Markdown s čínskym, japonským alebo arabským textom previesť do PDF?
Áno, cez váš prehliadač. Písma vložené do PDF tieto druhy písma neobsahujú, preto sa pri takom dokumente tlačidlo sťahovania zmení na Uložiť ako PDF a otvorí dialóg tlače, kde ako tlačiareň vyberiete Uložiť ako PDF. Prehliadač použije písma vášho systému, text sa bude dať označiť a arabčina či hebrejčina pôjde sprava doľava. Word (DOCX) a HTML tiež zachovajú všetky znaky.
Podporuje prevodník matematiku v LaTeXe alebo diagramy Mermaid?
Nie. Vzorce zapísané medzi znakmi dolára zostanú obyčajným textom a blok Mermaid sa prevedie ako každý iný blok kódu. Tabuľky, zoznamy úloh, poznámky pod čiarou, kód a všetko ostatné z GitHub Flavored Markdown je podporované vo všetkých formátoch.
Dá sa previesť Word alebo Google Docs na Markdown?
Áno, pomocou Markdown editora: vložte text skopírovaný z Wordu, Google Docs alebo webovej stránky a jeho formátovanie sa zmení na Markdown, vrátane nadpisov, zoznamov, odkazov a tabuliek. Spätný prevod PDF na Markdown podporovaný nie je, pretože PDF ukladá text rozmiestnený na strane, nie nadpisy, zoznamy a tabuľky.
Ako previesť tabuľku z Markdownu do Excelu?
Vložte Markdown s tabuľkou, vyberte Excel (XLSX) a stiahnite súbor. Z každej tabuľky sa stane hárok s číslami uloženými ako čísla. Ak potrebujete iba hodnoty v tabuľke, ktorú už máte otvorenú, kliknite na Kopírovať tabuľky a vložte ich do Excelu alebo Google Sheets.
Prečo Excel dá celý riadok CSV do jedného stĺpca?
Excel delí súbor CSV podľa oddeľovača zoznamu vo vašom systéme. V jazykoch, ktoré píšu desatinné čísla s čiarkou, napríklad v slovenčine, češtine, nemčine či francúzštine, je týmto oddeľovačom bodkočiarka. V časti Oddeľovač vyberte Bodkočiarka a stiahnite súbor znova. Ak diakritika vyzerá zle, nechajte zapnuté Kompatibilné s Excelom (UTF-8 s BOM).
Môžem poslať EPUB do svojho Kindlu?
Áno. Služba Send to Kindle od Amazonu, cez e-mail, v aplikácii Kindle alebo na webe Send to Kindle, prijíma súbory EPUB a prevedie ich do knižnice Kindle. Kindle Direct Publishing tiež prijíma EPUB, ak chcete knihu vydať.
Používa Jira Cloud ešte wiki markup?
V aktuálnom editore nie, ten číta Markdown a pri vkladaní alebo písaní ho mení na formátovanie. Formát Jira / Confluence je určený pre Jira a Confluence Data Center alebo Server a pre staršie polia, ktoré stále zobrazujú wiki markup. V Jira Cloud môžete namiesto toho vložiť pôvodný Markdown.
Dá sa súbor LaTeX otvoriť v Overleaf?
Áno. Vytvorte nový prázdny projekt, nahrajte súbor .tex alebo vložte jeho obsah a nahrajte aj obrázky, ktoré spomína. S voľbou Len telo, na vloženie do dokumentu dostanete iba obsah pre projekt, ktorý už má vlastnú preambulu.
Ako previesť Markdown na PDF alebo Word z príkazového riadka?
Bežným nástrojom je Pandoc (v angličtine): pandoc notes.md -o notes.docx hneď vytvorí súbor Word, zatiaľ čo výstup do PDF potrebuje aj nainštalovaný LaTeX. Táto stránka nevyžaduje inštaláciu a najprv vám ukáže náhľad, čo je jednoduchšie pri jednom dokumente alebo rýchlej dávke.
Je obmedzená veľkosť súboru alebo počet strán?
Každý súbor môže mať až 20 MB textu, čo je oveľa viac než akýkoľvek bežný dokument, a nie je tu žiadny limit strán ani vodoznak. Veľmi dlhé dokumenty s mnohými obrázkami sa vytvárajú niekoľko sekúnd, pretože všetku prácu robí váš vlastný počítač.
Ak chcete Markdown najprv napísať alebo upraviť, použite Markdown editor so živým náhľadom; jeho tlačidlo Ďalšie možnosti exportu otvorí tento prevodník s už vloženým textom. Ďalšie nástroje na prácu s textom nájdete v kategórii Text, napríklad počítadlo slov a znakov alebo nástroj na porovnanie dvoch textov.