DOCX Markdown átalakító
Ha a dokumentációt a Wordből egy Git-tárolóba költözteti, először minden .docx fájlt Markdownná kell alakítania. Ez az átalakító CommonMark-stílusú szöveget készít # címsorokkal, pipe-táblázatokkal és képhivatkozásokkal, amely azonnal commitolható.
Dokumentumkonvertáló
vagy húzza ide a(z) PDF, DOC, DOCX … fájlok fájlokat ·
Legfeljebb 95 MB fájlonként· Legfeljebb 20 fájl· Törlés 30 perc után
A fájlokat szervereinken dolgozzuk fel, és 30 perc után töröljük.
150 DPI-nél egy A4-es oldal körülbelül 1240 × 1754 px lesz. Nyomtatáshoz használjon 300-at.
A teljes fájlt vagy csak néhány oldalt, illetve diát alakítja át (PDF- és prezentációbemenet esetén).
Az átalakítandó oldalak vagy diák, pl. 1-3, 5, 8-10.
Az UTF-8 minden nyelvhez megfelel. Válassza a BOM-os UTF-8-at, ha a Windowson futó Excel vagy Jegyzettömb hibás karaktereket mutat; régi kódolásokat csak régi szoftverekhez használjon.
LF macOS-hez, Linuxhoz és kódszerkesztőkhöz; CRLF régebbi Windows-programokhoz, például a klasszikus Jegyzettömbhöz.
A vessző a szabvány. Pontosvesszőt használjon az Excelhez azokban az országokban, ahol a tizedeseket vesszővel írják (Németország, Franciaország, Brazília).
Több munkalapos Excel-bemenet esetén: mindet átalakítja (munkalaponként egy szakasz vagy fájl), vagy csak az elsőt.
Az eszköz használata
- 1
Töltse fel a Word-fájlokat
Legfeljebb 20 .docx vagy .doc fájlt adhat hozzá, fájlonként legfeljebb 95 MB-osat. A követett módosításokat előbb fogadja el vagy utasítsa el Wordben, mert a Markdown nem tudja megjeleníteni őket.
- 2
Ellenőrizze a szövegbeállításokat
A Formázás Egyszerű, a Szövegkódolás UTF-8, a Sorvégek pedig LF értéken áll; ezt a kombinációt várja a Git és a statikus oldalgenerátorok többsége. A Képek megtartása maradjon bekapcsolva, hogy a képek egy mappába kerüljenek.
- 3
Alakítsa át és csomagolja ki
Nyomja meg a Konvertálás erre: MD gombot. Minden dokumentum ZIP-ben érkezik, benne az .md fájllal és a képeivel; csomagolja ki a docs mappájába, majd commitolja.
Hogyan alakíthatok át egy Word-dokumentumot Markdownra?
Töltse fel a .docx fájlt, és nyomja meg a Konvertálás erre: MD gombot. Egyetlen ZIP-ben megkapja az .md fájlt # címsorokkal, listákkal, hivatkozásokkal és táblázatokkal, mellette pedig a képeket egy mappában.
DOCX Markdownná a docs-as-code munkafolyamathoz
A csapatok egyetlen okból választják a docs-as-code megközelítést: a dokumentáció így a kód mellett él, ugyanazokon a pull requesteken megy át, és ugyanazzal a kiadással jelenik meg. A .docx ezt megtöri, mert XML-részekből álló ZIP, amelyet a Git átláthatatlan binárisként tárol. Egyetlen szó módosítása is csak megváltozott fájlként látszik, olvasható diff nélkül, és ha ketten egyszerre szerkesztik, a munkájuk nem fésülhető össze.
A Markdown sima szöveg, így minden szerkesztés látható sorváltozás. 2014-ben ráadásul sokkal kiszámíthatóbb lett, amikor John MacFarlane és mások kiadták a CommonMarkot, annak a szintaxisnak a pontos leírását, amelyet Gruber tíz évvel korábban még csak lazán körvonalazott. A GitHub 2017-ben a CommonMarkra építette saját GitHub Flavored Markdown specifikációját, amely hozzáadta a ma a legtöbb README-ben használt pipe táblázatokat, feladatlistákat és áthúzást.
Ha a tartalom az ellenkező irányba tart, vagyis Markdownból egy Wordben dolgozó lektorhoz, használja a Markdown DOCX-be eszközt. Ha nem tárolóba, hanem weboldalra szánja, a DOCX HTML-be több formázást megőriz.
Így néz ki a Markdown kimenet
## Kiadási ellenőrzőlista A kiadás címkézése előtt ellenőrizze a következőket: - A tesztek lefutnak a **main** ágon - A változásnapló minden beolvasztott PR-t felsorol | Lépés | Felelős | | --- | --- | | Build | CI | | Közzététel | Karbantartó | 
Hol jelenik meg az átalakított Markdown
| Szervezet | Követelmény | Forrás |
|---|---|---|
| GitHub | A README.md és a tárolók bármely .md fájlját GitHub Flavored Markdownnal jeleníti meg | github.com |
| Hugo | Az .md tartalomfájlokból CommonMark-kompatibilis értelmezővel épít oldalakat | gohugo.io |
| Jekyll | A front matteres .md fájlokból oldalakat készít; a GitHub Pages motorja | jekyllrb.com |
| Docusaurus | A docs mappa .md és .mdx fájljait dokumentációs oldalként olvassa be | docusaurus.io |
DOCX
Microsoft Word dokumentum
A DOCX a Microsoft Word alapértelmezett dokumentumformátuma az Office 2007 óta, az Office Open XML szabványra (ECMA-376, ISO/IEC 29500) épül. XML-fájlokból álló ZIP-csomag, amely szöveget, stílusokat, képeket, táblázatokat, megjegyzéseket és követett változtatásokat tartalmaz. Irodákban, iskolákban és álláspályázatoknál ez a legelterjedtebb szerkeszthető dokumentumformátum. Az elrendezés kissé eltolódhat a Word, a Google Dokumentumok, a LibreOffice és a Pages között, főleg összetett formázásnál. A legtöbb szövegszerkesztő megnyitja a DOCX-fájlokat.
- Tömörítés
- –
- Átlátszóság
- –
- Animáció
- –
- Bevezetés éve
- 2007 · Microsoft
MD
Markdown
A Markdown egy könnyű jelölőnyelv, amelyet John Gruber alkotott 2004-ben. Egyszerű szöveges jeleket használ, például # a címsorokhoz, * a kiemeléshez és - a listákhoz, amelyek nyers szövegként is olvashatók, és tisztán alakíthatók HTML-lé. Ez a szabvány a README fájlokhoz, dokumentációkhoz, wikikhez, jegyzetalkalmazásokhoz és sok statikus oldalgenerátorhoz. Több nyelvjárása van, például a CommonMark és a GitHub Flavored Markdown, amelyek részletekben, például a táblázatoknál különböznek. Bármelyik szövegszerkesztő megnyitja a .md fájlokat.
- Tömörítés
- –
- Átlátszóság
- –
- Animáció
- –
- Bevezetés éve
- 2004 · John Gruber
A DOCX-et akkor érdemes Markdownra alakítani, ha a dokumentum kódalapú munkafolyamatba kerül: README-be, docs oldalra vagy Gitben tartott tudásbázisba, ahol a sima szöveg összehasonlítható, pull requestekben átnézhető, és sok eszköz megjeleníti.
Word-funkciók, amelyeknek nincs Markdown-megfelelője
Ezekre készüljön fel az átalakítás előtt
- A betűtípusok, a színek és az oldalelrendezés elvész; a Markdown a szerkezetet írja le, a megjelenést az oldal témája határozza meg
- A követett módosítások és a megjegyzések nem kerülnek át, ezért előbb oldja meg őket Wordben
- A élőfejnek, az élőlábnak és az oldalszámoknak nincs helye egy .md fájlban
- A szövegdobozok és a körbefuttatott képek hétköznapi bekezdésekké és képhivatkozásokká válnak
- A kézzel formázott címsorok, például a Címsor 2 helyett félkövér 16 pontos szöveg, félkövér szövegként jönnek ki, ezért előbb alkalmazzon valódi címsorstílusokat
- Az aláhúzásnak nincs Markdown-szintaxisa, ezért eltávolítjuk, vagy HTML-ként marad meg
Kérdések a DOCX Markdownná alakításáról
Melyik Markdown-változatot követi a DOCX–MD konvertálás eredménye?
A címsorok, a kiemelések, a listák, a hivatkozások és a kód a CommonMark szabályait követik, a táblázatok pedig a GitHub Flavored Markdown függőleges vonalas (pipe) szintaxisát használják. A GitHub, a GitLab, a Hugo, a Jekyll és a Docusaurus egyaránt megjeleníti ezt a kombinációt.
Mi történik az egyesített táblázatcellákkal?
A Markdown pipe táblázataiban nincsenek egyesített cellák, ezért minden egyesített területet külön cellákra bontunk vissza, a szöveg pedig az elsőbe kerül. Az összetett táblázatokat építse újra HTML-ként az .md fájlban, vagy egyszerűsítse őket Wordben a konvertálás előtt.
Hová kerülnek a Word-dokumentum képei?
Bekapcsolt Képek megtartása mellett minden kép külön fájlként kerül a ZIP-be, a Markdown pedig relatív útvonallal hivatkozik rá, például images/figure-1.png. Az .md fájl áthelyezésekor tartsa a mappát a fájl mellett.
Megmaradnak a Word lábjegyzetei a Markdownban?
A CommonMarkban nincs lábjegyzet-szintaxis, de a GitHub 2021-ben bevezette a [^1] lábjegyzeteket, és a legtöbb oldalgenerátor támogatja is őket. Ha az Ön megjelenítője nem, a lábjegyzetek szövege sima bekezdésként jelenik meg a végén.
Átalakíthatók így a Google Docs dokumentumok Markdownná?
Igen. A Google Dokumentumokban válassza a Fájl > Letöltés > Microsoft Word (.docx) menüpontot, majd töltse fel ide a fájlt. A Google Dokumentumok saját Markdown-letöltést is kínál, ami egyszerű dokumentumoknál jól működik.
