Převod DOCX do Markdownu
Přesun dokumentace z Wordu do repozitáře Git začíná převodem každého souboru .docx do Markdownu. Tento převodník vytváří text ve stylu CommonMark s nadpisy #, tabulkami se svislítky a odkazy na obrázky, připravený k commitu.
Převodník dokumentů
nebo sem přetáhněte soubory PDF, DOC, DOCX … ·
Max. 95 MB na soubor· Až 20 souborů· Smazáno po 30 minutách
Soubory se zpracovávají na našich serverech a po 30 minutách se smažou.
150 DPI změní stránku A4 na zhruba 1240 × 1754 px. Pro tisk použijte 300.
Převést celý soubor, nebo jen některé stránky či snímky (vstup PDF a prezentace).
Stránky nebo snímky k převodu, např. 1-3, 5, 8-10.
UTF-8 funguje pro všechny jazyky. Zvolte UTF-8 s BOM, pokud Excel nebo Poznámkový blok ve Windows zobrazuje rozbité znaky; starší kódování jen pro starý software.
LF pro macOS, Linux a editory kódu; CRLF pro starší programy ve Windows, například klasický Poznámkový blok.
Standardem je čárka. Středník použijte pro Excel v zemích, kde se desetinná místa píší s čárkou (Německo, Francie, Brazílie).
Vstup Excel s více listy: převést všechny (jedna sekce nebo soubor na list), nebo jen první.
Jak nástroj používat
- 1
Nahrajte soubory Wordu
Přidejte až 20 souborů .docx nebo .doc, každý do 95 MB. Změny sledování nejprve přijměte nebo zamítněte ve Wordu, protože je Markdown neumí zobrazit.
- 2
Zkontrolujte volby textu
Formátování je nastaveno na Jednoduché, Kódování textu na UTF-8 a Konce řádků na LF, tedy kombinaci, kterou očekávají Git i generátory statických webů. Ponechte zapnuté Zahrnout obrázky, aby se obrázky uložily do složky.
- 3
Převeďte a rozbalte
Stiskněte Převést na MD. Každý dokument dorazí jako ZIP se souborem .md a jeho obrázky; rozbalte jej do složky s dokumentací a proveďte commit.
Jak převést dokument Word do Markdownu?
Nahrajte soubor .docx a stiskněte Převést na MD. Získáte soubor .md s nadpisy #, seznamy, odkazy a tabulkami a vedle něj složku s obrázky, vše v jednom ZIPu.
DOCX do Markdownu pro docs-as-code
Týmy používají docs-as-code z jednoho důvodu: dokumentace pak leží vedle kódu, prochází stejnými pull requesty a vychází se stejným vydáním. Soubor .docx to narušuje, protože je to ZIP s částmi XML, které Git ukládá jako neprůhledný binární soubor. Změna jednoho slova se projeví jako změněný soubor bez čitelného rozdílu a dva lidé editující současně nemohou své práce sloučit.
Markdown je prostý text, takže každá úprava je viditelná změna řádku. V roce 2014 se také stal mnohem předvídatelnějším, když John MacFarlane a další zveřejnili CommonMark, přesnou specifikaci syntaxe, kterou Gruber popsal volně o deset let dříve. GitHub na CommonMarku v roce 2017 postavil vlastní specifikaci GitHub Flavored Markdown a přidal tabulky se svislítky, seznamy úkolů a přeškrtnutí, které dnes používá většina souborů README.
Pokud váš obsah míří opačným směrem, tedy z Markdownu k recenzentovi pracujícímu ve Wordu, použijte Markdown do DOCX. Pro webovou stránku místo repozitáře zachová více stylů DOCX do HTML.
Jak vypadá výstup v Markdownu
## Kontrolní seznam vydání Před označením vydání ověřte následující: - Testy procházejí na **main** - Changelog uvádí každý sloučený PR | Krok | Odpovídá | | --- | --- | | Sestavení | CI | | Publikace | Správce | 
Kde se převedený Markdown zobrazí
| Organizace | Požadavek | Zdroj |
|---|---|---|
| GitHub | Zobrazuje README.md a jakýkoli soubor .md v repozitáři pomocí GitHub Flavored Markdown | github.com |
| Hugo | Vytváří stránky ze souborů obsahu .md pomocí parseru kompatibilního s CommonMark | gohugo.io |
| Jekyll | Mění soubory .md s front matter na stránky; engine za GitHub Pages | jekyllrb.com |
| Docusaurus | Čte soubory .md a .mdx ve složce docs jako stránky dokumentace | docusaurus.io |
DOCX
Dokument Microsoft Word
DOCX je výchozí formát dokumentů Microsoft Wordu od Office 2007, založený na standardu Office Open XML (ECMA-376, ISO/IEC 29500). Je to balíček ZIP se soubory XML, který obsahuje text, styly, obrázky, tabulky, komentáře a sledované změny. Je to nejběžnější formát upravitelných dokumentů v kancelářích, školách i při výběrových řízeních. Rozvržení se může mezi Wordem, Google Docs, LibreOffice a Pages mírně lišit, zejména u složitého formátování. DOCX otevře většina textových editorů.
- Komprese
- –
- Průhlednost
- –
- Animace
- –
- Představeno
- 2007 · Microsoft
MD
Markdown
Markdown je odlehčená značkovací syntaxe, kterou v roce 2004 vytvořil John Gruber. Používá symboly v prostém textu, například # pro nadpisy, * pro zvýraznění a - pro seznamy, které zůstávají čitelné i jako surový text a čistě se převádějí na HTML. Je standardem pro soubory README, dokumentaci, wiki, aplikace pro poznámky i mnoho generátorů statických webů. Existuje několik dialektů, například CommonMark a GitHub Flavored Markdown, které se liší v detailech, třeba v tabulkách. Soubory .md otevře jakýkoli textový editor.
- Komprese
- –
- Průhlednost
- –
- Animace
- –
- Představeno
- 2004 · John Gruber
DOCX se převádí do Markdownu, když dokument přechází do pracovního postupu s kódem: README, web s dokumentací nebo znalostní báze v Gitu, kde lze prostý text porovnávat, kontrolovat v pull requestech a zobrazit mnoha nástroji.
Funkce Wordu, které v Markdownu nemají obdobu
Na tohle se připravte před převodem
- Fonty, barvy a rozvržení stránky se zahodí; Markdown popisuje strukturu a vzhled určuje motiv webu
- Sledované změny a komentáře se nepřenesou, proto je nejprve vyřešte ve Wordu
- Záhlaví, zápatí a čísla stránek v souboru .md nemají místo
- Textová pole a obrázky s obtékáním se stanou běžnými odstavci a odkazy na obrázky
- Nadpisy formátované ručně, tučně 16 pt místo stylu Nadpis 2, se převedou jako tučný text, proto nejprve použijte skutečné styly nadpisů
- Podtržení nemá v Markdownu syntaxi a odstraní se nebo zůstane jako HTML
Otázky k převodu DOCX do Markdownu
Jakou variantu Markdownu výstup z DOCX do MD dodržuje?
Nadpisy, zvýraznění, seznamy, odkazy i kód se řídí CommonMark a tabulky používají syntaxi s svislítky z GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll i Docusaurus tuto kombinaci zobrazují.
Co se stane se sloučenými buňkami tabulky?
Tabulky Markdown se svislítky nemají sloučené buňky, proto se každá sloučená oblast rozdělí zpět na jednotlivé buňky a text zůstane v první z nich. Složité tabulky vytvořte znovu jako HTML uvnitř souboru .md nebo je před převodem zjednodušte ve Wordu.
Kam se uloží obrázky z dokumentu Wordu?
Při zapnuté volbě Zahrnout obrázky se každý obrázek uloží do ZIPu jako samostatný soubor a Markdown na něj odkazuje relativní cestou, například images/figure-1.png. Při přesunu ponechte složku vedle souboru .md.
Zachovají se poznámky pod čarou z Wordu v Markdownu?
CommonMark nemá syntaxi poznámek pod čarou, ale GitHub v roce 2021 přidal poznámky [^1] a většina generátorů webů je podporuje. Pokud je váš renderer nepodporuje, text poznámek se zobrazí na konci jako běžné odstavce.
Mohu tímto způsobem převést Google Docs do Markdownu?
Ano. V Dokumentech Google zvolte Soubor > Stáhnout > Microsoft Word (.docx) a tento soubor sem nahrajte. Dokumenty Google nabízejí i vlastní stažení do Markdownu, které u jednoduchých dokumentů funguje dobře.
