Pretvornik DOCX v Markdown
Selitev dokumentacije iz Worda v repozitorij Git se začne s pretvorbo vsake datoteke .docx v Markdown. Ta pretvornik ustvari besedilo v slogu CommonMark z naslovi #, tabelami s pokončnicami in povezavami do slik, pripravljeno za commit.
Pretvornik dokumentov
ali spustite datoteke PDF, DOC, DOCX … sem ·
Največ 95 MB na datoteko· Do 20 datotek· Izbrisano po 30 minutah
Datoteke se obdelajo na naših strežnikih in izbrišejo po 30 minutah.
150 DPI pretvori stran A4 v približno 1240 × 1754 px. Za tiskanje uporabite 300.
Pretvori celotno datoteko ali le nekatere strani ali diapozitive (vhod PDF in predstavitve).
Strani ali diapozitivi za pretvorbo, npr. 1-3, 5, 8-10.
UTF-8 deluje za vse jezike. Izberite UTF-8 z BOM, če Excel ali Beležnica v sistemu Windows prikažeta popačene znake; starejše kodiranje samo za staro programsko opremo.
LF za macOS, Linux in urejevalnike kode; CRLF za starejše programe v sistemu Windows, kot je klasična Beležnica.
Vejica je standard. Podpičje uporabite za Excel v državah, ki decimalke pišejo z vejico (Nemčija, Francija, Brazilija).
Excel z več listi: pretvori vse (en razdelek ali datoteka na list) ali samo prvega.
Kako uporabljati to orodje
- 1
Naložite datoteke Word
Dodajte do 20 datotek .docx ali .doc, vsaka do 95 MB. Sledene spremembe najprej sprejmite ali zavrnite v Wordu, saj jih Markdown ne more prikazati.
- 2
Preverite možnosti besedila
Oblikovanje je nastavljeno na Preprosto, Kodiranje besedila na UTF-8 in Konci vrstic na LF, kar pričakujejo Git in generatorji statičnih strani. Pustite vključeno možnost Vključi slike, da dobite slike v mapi.
- 3
Pretvorite in razpakirajte
Pritisnite Pretvori v MD. Vsak dokument prejmete kot ZIP z datoteko .md in njenimi slikami; razpakirajte ga v mapo z dokumentacijo in objavite spremembe (commit).
Kako pretvorim Wordov dokument v Markdown?
Naložite datoteko .docx in pritisnite Pretvori v MD. Dobite datoteko .md z naslovi #, seznami, povezavami in tabelami ter slike v mapi ob njej, vse v enem ZIP-u.
DOCX v Markdown za docs-as-code
Ekipe sprejmejo pristop docs-as-code iz enega razloga: dokumentacija je tako ob kodi, gre skozi iste pull requeste in izide z isto izdajo. Datoteka .docx to onemogoča, saj je ZIP delov XML, ki ga Git hrani kot neprozorno binarno datoteko. Sprememba ene besede se pokaže kot spremenjena datoteka brez berljivih razlik, dva sočasna urejevalca pa dela ne moreta združiti.
Markdown je navadno besedilo, zato je vsaka sprememba vidna kot sprememba vrstice. Leta 2014 je postal tudi veliko bolj predvidljiv, ko so John MacFarlane in drugi objavili CommonMark, natančno specifikacijo sintakse, ki jo je Gruber deset let prej opisal ohlapno. GitHub je leta 2017 svojo specifikacijo GitHub Flavored Markdown zasnoval na CommonMarku in dodal tabele, sezname opravil in prečrtano besedilo, ki jih danes uporablja večina datotek README.
Če vsebina potuje v nasprotno smer, iz Markdowna k recenzentu, ki dela v Wordu, uporabite Markdown v DOCX. Za spletno stran namesto repozitorija DOCX v HTML ohrani več oblikovanja.
Kako je videti izhod v Markdownu
## Kontrolni seznam za izdajo Pred označitvijo izdaje preverite naslednje: - Testi uspešno tečejo na veji **main** - Dnevnik sprememb navaja vsak združeni PR | Korak | Odgovorna oseba | | --- | --- | | Gradnja | CI | | Objava | Vzdrževalec | 
Kje bo pretvorjeni Markdown prikazan
| Organizacija | Zahteva | Vir |
|---|---|---|
| GitHub | Prikaže README.md in vsako datoteko .md v repozitoriju z GitHub Flavored Markdown | github.com |
| Hugo | Izdela strani iz vsebinskih datotek .md z razčlenjevalnikom, skladnim s CommonMark | gohugo.io |
| Jekyll | Datoteke .md s front matter spremeni v strani; ogrodje za GitHub Pages | jekyllrb.com |
| Docusaurus | Datoteke .md in .mdx v mapi docs prebere kot strani dokumentacije | docusaurus.io |
DOCX
Dokument Microsoft Word
DOCX je privzeta oblika dokumentov v programu Microsoft Word od paketa Office 2007, ki temelji na standardu Office Open XML (ECMA-376, ISO/IEC 29500). Je paket ZIP z datotekami XML, ki vsebuje besedilo, sloge, slike, tabele, komentarje in sledene spremembe. Je najpogostejša oblika za urejanje dokumentov v pisarnah, šolah in pri prijavah za delo. Postavitev se lahko med programi Word, Google Docs, LibreOffice in Pages rahlo premakne, zlasti pri zahtevnem oblikovanju. DOCX odpre večina urejevalnikov besedil.
- Stiskanje
- –
- Prosojnost
- –
- Animacija
- –
- Uvedeno
- 2007 · Microsoft
MD
Markdown
Markdown je lahka označevalna sintaksa, ki jo je leta 2004 ustvaril John Gruber. Uporablja simbole v navadnem besedilu, na primer # za naslove, * za poudarek in - za sezname, ki ostanejo berljivi tudi kot surovo besedilo in se čisto pretvorijo v HTML. Je standard za datoteke README, dokumentacijo, wikije, aplikacije za zapiske in številne generatorje statičnih spletnih mest. Obstaja več narečij, kot sta CommonMark in GitHub Flavored Markdown, ki se razlikujeta v podrobnostih, na primer pri tabelah. Datoteke .md odpre vsak urejevalnik besedil.
- Stiskanje
- –
- Prosojnost
- –
- Animacija
- –
- Uvedeno
- 2004 · John Gruber
DOCX se pretvori v Markdown, ko dokument preide v delovni tok s kodo: README, spletno mesto z dokumentacijo ali baza znanja v Gitu, kjer je mogoče navadno besedilo primerjati, pregledati v pull requestih in prikazati z mnogimi orodji.
Funkcije Worda, ki v Markdownu nimajo ustreznice
Na to se pripravite pred pretvorbo
- Pisave, barve in postavitev strani se opustijo; Markdown opisuje strukturo, videz pa določa tema spletnega mesta
- Sledene spremembe in komentarji se ne prenesejo, zato jih najprej razrešite v Wordu
- Glave, noge in številke strani v datoteki .md nimajo mesta
- Besedilna polja in slike z obtekanjem postanejo navadni odstavki in povezave do slik
- Naslovi, oblikovani ročno, krepko 16 pt namesto Naslov 2, se pretvorijo v krepko besedilo, zato najprej uporabite prave sloge naslovov
- Podčrtanje v Markdownu nima sintakse in je odstranjeno ali ohranjeno kot HTML
Vprašanja o pretvorbi DOCX v Markdown
Kateri različici Markdowna sledi izhod pretvorbe DOCX v MD?
Naslovi, poudarki, seznami, povezave in koda sledijo standardu CommonMark, tabele pa uporabljajo sintakso s presledniki | iz GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll in Docusaurus prikažejo to kombinacijo.
Kaj se zgodi z združenimi celicami tabele?
Markdownove tabele s črtami | nimajo združenih celic, zato se vsako združeno območje razdeli nazaj na posamezne celice z besedilom v prvi. Zahtevne tabele ponovno izdelajte kot HTML znotraj datoteke .md ali jih pred pretvorbo poenostavite v Wordu.
Kam gredo slike iz mojega dokumenta Word?
Ko je vključena možnost Vključi slike, je vsaka slika shranjena kot ločena datoteka v ZIP-u, Markdown pa nanjo kaže z relativno potjo, na primer images/figure-1.png. Ob premikanju datoteke .md mapo obdržite poleg nje.
Ali se sprotne opombe iz Worda ohranijo v Markdownu?
CommonMark nima sintakse za opombe, vendar je GitHub leta 2021 dodal opombe [^1] in jih podpira večina generatorjev strani. Če jih vaš prikazovalnik ne podpira, se besedilo opombe na koncu pokaže kot navadni odstavki.
Ali lahko na ta način pretvorim Google Docs v Markdown?
Da. V Google Dokumentih izberite Datoteka > Prenesi > Microsoft Word (.docx) in nato to datoteko naložite tukaj. Google Dokumenti ponujajo tudi lastni prenos v Markdown, ki dobro deluje pri preprostih dokumentih.
