DOCX til Markdown-konverter
Når dokumentation skal flyttes fra Word til et Git-repository, starter det med at gøre hver .docx til Markdown. Denne konverter skriver tekst i CommonMark-stil med #-overskrifter, pipe-tabeller og billedlinks, klar til commit.
Dokumentkonverter
eller slip PDF, DOC, DOCX …-filer her ·
Maks. 95 MB pr. fil· Op til 20 filer· Slettes efter 30 minutter
Filer behandles på vores servere og slettes efter 30 minutter.
150 DPI gør en A4-side til ca. 1240 × 1754 px. Brug 300 til udskrivning.
Konvertér hele filen eller kun nogle sider eller slides (PDF- og præsentationsinput).
Sider eller slides, der skal konverteres, f.eks. 1-3, 5, 8-10.
UTF-8 fungerer til alle sprog. Vælg UTF-8 med BOM, hvis Excel eller Notepad på Windows viser forkerte tegn; ældre kodninger kun til gammelt software.
LF til macOS, Linux og kodeeditorer; CRLF til ældre Windows-programmer som det klassiske Notepad.
Komma er standard. Brug semikolon til Excel i lande, hvor decimaler skrives med komma (Danmark, Tyskland, Frankrig, Brasilien).
Excel-input med flere ark: konvertér alle (ét afsnit eller én fil pr. ark) eller kun det første.
Sådan bruger du værktøjet
- 1
Upload Word-filerne
Tilføj op til 20 .docx- eller .doc-filer på op til 95 MB hver. Accepter eller afvis sporede ændringer i Word først, da Markdown ikke kan vise dem.
- 2
Tjek tekstindstillingerne
Formatering er sat til Simpel, Tekstkodning til UTF-8 og Linjeskift til LF, den kombination som Git og statiske sitegeneratorer forventer. Lad Medtag billeder være slået til, så du får billederne i en mappe.
- 3
Konvertér og udpak
Tryk på Konvertér til MD. Hvert dokument kommer som en ZIP med .md-filen og dens billeder. Udpak den i din docs-mappe og commit.
Hvordan konverterer jeg et Word-dokument til Markdown?
Upload .docx-filen og tryk på Konvertér til MD. Du får en .md-fil med #-overskrifter, lister, links og tabeller samt billederne i en mappe ved siden af, alt sammen i én ZIP.
DOCX til Markdown til docs-as-code
Teams vælger docs-as-code af én grund: dokumentationen ligger så ved siden af koden, gennemgår de samme pull requests og udkommer med samme release. En .docx bryder det, fordi den er en ZIP af XML-dele, som Git gemmer som en uigennemsigtig binær fil. En ændring på ét ord vises som en ændret fil uden læsbar diff, og to personer, der redigerer samtidig, kan ikke flette deres arbejde.
Markdown er almindelig tekst, så hver redigering er en synlig linjeændring. Det blev også langt mere forudsigeligt i 2014, da John MacFarlane og andre udgav CommonMark, en præcis specifikation af den syntaks, som Gruber havde beskrevet løst ti år tidligere. GitHub byggede i 2017 sin egen GitHub Flavored Markdown-specifikation på CommonMark og tilføjede pipetabeller, opgavelister og gennemstregning, som de fleste README-filer bruger i dag.
Hvis indholdet skal den anden vej, Markdown ud til en reviewer, der arbejder i Word, så brug Markdown til DOCX. Til en webside frem for et repository bevarer DOCX til HTML mere af layoutet.
Sådan ser Markdown-resultatet ud
## Tjekliste til release Bekræft følgende, før en release tagges: - Testene består på **main** - Changeloggen nævner alle flettede PR'er | Trin | Ansvarlig | | --- | --- | | Build | CI | | Udgivelse | Vedligeholder | 
Hvor den konverterede Markdown vises
| Organisation | Krav | Kilde |
|---|---|---|
| GitHub | Gengiver README.md og alle .md-filer i et repository med GitHub Flavored Markdown | github.com |
| Hugo | Bygger sider ud fra .md-indholdsfiler med en CommonMark-kompatibel parser | gohugo.io |
| Jekyll | Omdanner .md-filer med front matter til sider; motoren bag GitHub Pages | jekyllrb.com |
| Docusaurus | Læser .md- og .mdx-filer i sin docs-mappe som dokumentationssider | docusaurus.io |
DOCX
Microsoft Word-dokument
DOCX har været Microsoft Words standarddokumentformat siden Office 2007 og bygger på standarden Office Open XML (ECMA-376, ISO/IEC 29500). Det er en ZIP-pakke med XML-filer, der indeholder tekst, typografier, billeder, tabeller, kommentarer og sporede ændringer. Det er det mest almindelige format til redigerbare dokumenter på kontorer, i skoler og ved jobansøgninger. Layoutet kan flytte sig lidt mellem Word, Google Docs, LibreOffice og Pages, især ved kompleks formatering. De fleste tekstbehandlingsprogrammer åbner DOCX-filer.
- Komprimering
- –
- Gennemsigtighed
- –
- Animation
- –
- Introduceret
- 2007 · Microsoft
MD
Markdown
Markdown er en let opmærkningssyntaks skabt af John Gruber i 2004. Den bruger almindelige tekstsymboler, f.eks. # til overskrifter, * til fremhævelse og - til lister, som forbliver læselige som ren tekst og kan konverteres rent til HTML. Den er standarden for README-filer, dokumentation, wikier, notatapps og mange statiske webstedsgeneratorer. Der findes flere dialekter, f.eks. CommonMark og GitHub Flavored Markdown, som afviger i detaljer som tabeller. Enhver teksteditor kan åbne .md-filer.
- Komprimering
- –
- Gennemsigtighed
- –
- Animation
- –
- Introduceret
- 2004 · John Gruber
DOCX konverteres til Markdown, når et dokument flytter ind i et kodeworkflow: en README, et dokumentationssite eller en vidensbase i Git, hvor almindelig tekst kan sammenlignes, gennemgås i pull requests og gengives af mange værktøjer.
Word-funktioner uden modstykke i Markdown
Tag højde for disse, før du konverterer
- Skrifttyper, farver og sidelayout fjernes; Markdown beskriver struktur, og sitets tema bestemmer udseendet
- Sporede ændringer og kommentarer følger ikke med, så løs dem i Word først
- Sidehoveder, sidefødder og sidetal har ingen plads i en .md-fil
- Tekstbokse og billeder med tekstombrydning bliver til almindelige afsnit og billedlinks
- Overskrifter, du har formateret i hånden, fed 16 pt i stedet for Overskrift 2, kommer ud som fed tekst, så brug rigtige overskriftsttypografier først
- Understregning har ingen Markdown-syntaks og fjernes eller beholdes som HTML
Spørgsmål om DOCX til Markdown
Hvilken Markdown-variant følger DOCX til MD-resultatet?
Overskrifter, fremhævning, lister, links og kode følger CommonMark, og tabeller bruger pipe-syntaksen fra GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll og Docusaurus gengiver alle den kombination.
Hvad sker der med flettede tabelceller?
Markdown-pipetabeller har ikke sammenflettede celler, så hvert sammenflettet område deles op i enkeltceller, hvor teksten står i den første. Genopbyg komplekse tabeller som HTML i .md-filen, eller forenkl dem i Word før konverteringen.
Hvor ender billederne fra mit Word-dokument?
Når Medtag billeder er slået til, gemmes hvert billede som en separat fil i ZIP-filen, og Markdown linker til det med en relativ sti som images/figure-1.png. Behold mappen ved siden af .md-filen, når du flytter den.
Bevares fodnoter fra Word i Markdown?
CommonMark har ingen syntaks for fodnoter, men GitHub tilføjede [^1]-fodnoter i 2021, og de fleste sitegeneratorer understøtter dem. Gør din renderer ikke, står noteteksten som almindelige afsnit til sidst.
Kan jeg konvertere Google Docs til Markdown på denne måde?
Ja. I Google Docs vælger du Filer > Download > Microsoft Word (.docx) og uploader derefter filen her. Google Docs har også sin egen Markdown-download, som fungerer godt til enkle dokumenter.
