Prevod DOCX do Markdown
Presun dokumentácie z Wordu do repozitára Git sa začína prevodom každého súboru .docx do Markdownu. Tento konvertor vytvára text v štýle CommonMark s nadpismi #, tabuľkami so zvislými čiarami a odkazmi na obrázky, pripravený na commit.
Prevodník dokumentov
alebo sem presuňte súbory PDF, DOC, DOCX … ·
Max. 95 MB na súbor· Až 20 súborov· Odstránenie po 30 minútach
Súbory sa spracúvajú na našich serveroch a po 30 minútach sa odstránia.
150 DPI zmení stranu A4 na približne 1240 × 1754 px. Na tlač použite 300.
Previesť celý súbor alebo len niektoré strany či snímky (vstup PDF a prezentácie).
Strany alebo snímky na prevod, napr. 1-3, 5, 8-10.
UTF-8 funguje pre všetky jazyky. Vyberte UTF-8 s BOM, ak Excel alebo Poznámkový blok vo Windowse zobrazuje pokazené znaky; staršie kódovania len pre starý softvér.
LF pre macOS, Linux a editory kódu; CRLF pre staršie programy vo Windowse, napríklad klasický Poznámkový blok.
Štandardom je čiarka. Bodkočiarku použite pre Excel v krajinách, kde sa desatinné čísla píšu s čiarkou (Nemecko, Francúzsko, Brazília).
Vstup z Excelu s viacerými hárkami: previesť všetky (jedna sekcia alebo súbor na hárok) alebo len prvý.
Ako používať tento nástroj
- 1
Nahrajte súbory Wordu
Pridajte až 20 súborov .docx alebo .doc, každý do 95 MB. Sledované zmeny najprv prijmite alebo zamietnite vo Worde, pretože Markdown ich nijako nezobrazí.
- 2
Skontrolujte možnosti textu
Formátovanie je nastavené na Jednoduché, Kódovanie textu na UTF-8 a Konce riadkov na LF, teda kombinácia, ktorú očakávajú Git a generátory statických stránok. Ponechajte zapnuté Zahrnúť obrázky, aby sa obrázky uložili do priečinka.
- 3
Preveďte a rozbaľte
Stlačte Previesť na MD. Každý dokument príde ako ZIP so súborom .md a jeho obrázkami; rozbaľte ho do priečinka s dokumentáciou a odovzdajte do repozitára.
Ako previesť dokument Word do Markdownu?
Nahrajte súbor .docx a stlačte Previesť na MD. Dostanete súbor .md s nadpismi #, zoznamami, odkazmi a tabuľkami a vedľa neho obrázky v priečinku, všetko v jednom ZIP.
DOCX do Markdownu pre docs-as-code
Tímy používajú prístup docs-as-code z jedného dôvodu: dokumentácia potom leží vedľa kódu, prechádza rovnakými pull requestmi a vychádza s rovnakým vydaním. Súbor .docx to narúša, pretože je to ZIP s časťami XML, ktorý Git ukladá ako nepriehľadný binárny súbor. Zmena jedného slova sa zobrazí ako zmenený súbor bez čitateľného rozdielu a dvaja ľudia, ktorí upravujú naraz, nemôžu svoju prácu zlúčiť.
Markdown je obyčajný text, takže každá úprava je viditeľná zmena riadku. V roku 2014 sa tiež stal oveľa predvídateľnejším, keď John MacFarlane a ďalší zverejnili CommonMark, presnú špecifikáciu syntaxe, ktorú Gruber popísal voľne o desať rokov skôr. GitHub v roku 2017 založil vlastnú špecifikáciu GitHub Flavored Markdown na CommonMark a pridal tabuľky so zvislými čiarami, zoznamy úloh a preškrtnutie, ktoré používa väčšina dnešných README.
Ak ide váš obsah opačným smerom, z Markdownu k recenzentovi, ktorý pracuje vo Worde, použite Markdown do DOCX. Pre webovú stránku namiesto repozitára zachová viac štýlov DOCX do HTML.
Ako vyzerá výstup v Markdowne
## Kontrolný zoznam vydania Pred označením vydania overte: - Testy prechádzajú na **main** - Zoznam zmien obsahuje každý zlúčený PR | Krok | Zodpovedá | | --- | --- | | Zostavenie | CI | | Publikovanie | Správca | 
Kde sa prevedený Markdown zobrazí
| Organizácia | Požiadavka | Zdroj |
|---|---|---|
| GitHub | Zobrazuje README.md a každý súbor .md v repozitári pomocou GitHub Flavored Markdown | github.com |
| Hugo | Vytvára stránky zo súborov obsahu .md pomocou parsera kompatibilného s CommonMark | gohugo.io |
| Jekyll | Mení súbory .md s front matter na stránky; je to nástroj za GitHub Pages | jekyllrb.com |
| Docusaurus | Číta súbory .md a .mdx v priečinku docs ako stránky dokumentácie | docusaurus.io |
DOCX
Dokument Microsoft Word
DOCX je predvolený formát dokumentov programu Microsoft Word od Office 2007, založený na štandarde Office Open XML (ECMA-376, ISO/IEC 29500). Je to balík ZIP so súbormi XML, ktoré obsahujú text, štýly, obrázky, tabuľky, komentáre a sledované zmeny. Je to najbežnejší formát upraviteľných dokumentov v kanceláriách, školách aj pri žiadostiach o prácu. Rozloženie sa môže medzi Wordom, Google Docs, LibreOffice a Pages mierne posunúť, najmä pri zložitom formátovaní. Súbory DOCX otvorí väčšina textových editorov.
- Kompresia
- –
- Priehľadnosť
- –
- Animácia
- –
- Rok vzniku
- 2007 · Microsoft
MD
Markdown
Markdown je ľahká značkovacia syntax, ktorú v roku 2004 vytvoril John Gruber. Používa symboly v čistom texte, napríklad # pre nadpisy, * pre zvýraznenie a - pre zoznamy, ktoré zostávajú čitateľné aj ako surový text a čisto sa konvertujú na HTML. Je štandardom pre súbory README, dokumentáciu, wiki, aplikácie na poznámky a mnohé generátory statických webov. Existuje niekoľko dialektov, napríklad CommonMark a GitHub Flavored Markdown, ktoré sa líšia v detailoch, ako sú tabuľky. Súbory .md otvorí každý textový editor.
- Kompresia
- –
- Priehľadnosť
- –
- Animácia
- –
- Rok vzniku
- 2004 · John Gruber
DOCX sa prevádza na Markdown, keď dokument prechádza do vývojárskeho pracovného postupu: README, stránka s dokumentáciou alebo znalostná báza vedená v Gite, kde sa dá obyčajný text porovnávať, kontrolovať v pull requestoch a zobraziť mnohými nástrojmi.
Funkcie Wordu, ktoré v Markdowne nemajú obdobu
Na toto sa pripravte pred prevodom
- Písma, farby a rozloženie strany sa vynechajú; Markdown popisuje štruktúru a vzhľad určuje téma stránky
- Sledované zmeny a komentáre sa neprenesú, preto ich najprv vyriešte vo Worde
- Hlavičky, päty a čísla strán nemajú v súbore .md miesto
- Textové polia a obrázky s obtekaním sa zmenia na bežné odseky a odkazy na obrázky
- Nadpisy naformátované ručne, tučné písmo 16 pt namiesto Nadpisu 2, sa prevedú ako tučný text, preto najprv použite skutočné štýly nadpisov
- Podčiarknutie nemá v Markdowne syntax a odstráni sa alebo zostane ako HTML
Otázky k prevodu DOCX do Markdownu
Ktorý variant Markdownu používa výstup prevodu DOCX do MD?
Nadpisy, zvýraznenie, zoznamy, odkazy a kód sa riadia štandardom CommonMark a tabuľky používajú zvislú syntax z GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll aj Docusaurus túto kombináciu zobrazia správne.
Čo sa stane so zlúčenými bunkami tabuľky?
Tabuľky v Markdowne so zvislými čiarami nemajú zlúčené bunky, preto sa každá zlúčená oblasť rozdelí späť na jednotlivé bunky a text zostane v prvej z nich. Zložité tabuľky vytvorte znova ako HTML vo vnútri súboru .md alebo ich pred prevodom zjednodušte vo Worde.
Kam sa uložia obrázky z môjho dokumentu Word?
So zapnutou voľbou Zahrnúť obrázky sa každý obrázok uloží ako samostatný súbor v ZIP a Markdown naň odkazuje relatívnou cestou, napríklad images/figure-1.png. Pri presune súboru .md nechajte priečinok s obrázkami vedľa neho.
Zachovajú sa poznámky pod čiarou z Wordu v Markdowne?
CommonMark nemá syntax pre poznámky pod čiarou, ale GitHub v roku 2021 pridal poznámky [^1] a podporuje ich väčšina generátorov stránok. Ak ich váš renderer nepodporuje, text poznámok sa zobrazí na konci ako obyčajné odseky.
Môžem takto previesť Google Docs do Markdownu?
Áno. V Dokumentoch Google zvoľte Súbor > Stiahnuť > Microsoft Word (.docx) a tento súbor nahrajte sem. Dokumenty Google ponúkajú aj vlastné sťahovanie do Markdownu, ktoré dobre funguje pri jednoduchých dokumentoch.
