DOCX naar Markdown converteren
Wie documentatie uit Word naar een Git-repository verhuist, begint met het omzetten van elk .docx-bestand naar Markdown. Deze converter schrijft tekst in CommonMark-stijl met #-koppen, pipe-tabellen en afbeeldingslinks, klaar om te committen.
Documentconverter
of sleep PDF, DOC, DOCX …-bestanden hierheen ·
Max. 95 MB per bestand· Tot 20 bestanden· Verwijderd na 30 minuten
Bestanden worden op onze servers verwerkt en na 30 minuten verwijderd.
150 DPI maakt van een A4-pagina ongeveer 1240 × 1754 px. Gebruik 300 om af te drukken.
Converteer het hele bestand of alleen enkele pagina's of dia's (PDF- en presentatie-invoer).
Pagina's of dia's om te converteren, bijv. 1-3, 5, 8-10.
UTF-8 werkt voor alle talen. Kies UTF-8 met BOM als Excel of Kladblok op Windows onleesbare tekens toont; oude coderingen alleen voor oude software.
LF voor macOS, Linux en code-editors; CRLF voor oudere Windows-programma's zoals het klassieke Kladblok.
Komma is de standaard. Gebruik puntkomma voor Excel in landen waar decimalen met een komma worden geschreven (Nederland, Duitsland, Frankrijk, Brazilië).
Excel-invoer met meerdere bladen: converteer ze allemaal (één sectie of bestand per blad) of alleen het eerste.
Zo gebruikt u deze tool
- 1
Upload de Word-bestanden
Voeg maximaal 20 .docx- of .doc-bestanden toe, elk tot 95 MB. Accepteer of weiger eerst de bijgehouden wijzigingen in Word, want Markdown kan die niet weergeven.
- 2
Controleer de tekstopties
Opmaak staat op Eenvoudig, Tekstcodering op UTF-8 en Regeleinden op LF, de combinatie die Git en generators voor statische sites verwachten. Laat Afbeeldingen opnemen aan staan om de afbeeldingen in een map te krijgen.
- 3
Converteer en pak uit
Klik op Converteren naar MD. Elk document komt als ZIP met het .md-bestand en de bijbehorende afbeeldingen; pak het uit in uw docs-map en commit het.
Hoe converteer ik een Word-document naar Markdown?
Upload het .docx-bestand en klik op Converteren naar MD. U krijgt een .md-bestand met #-koppen, lijsten, links en tabellen, plus de afbeeldingen in een map ernaast, alles in één ZIP.
DOCX naar Markdown voor docs-as-code
Teams kiezen voor docs-as-code om één reden: de documentatie staat dan naast de code, doorloopt dezelfde pull requests en wordt met dezelfde release meegeleverd. Een .docx doorbreekt dat, omdat het een ZIP met XML-onderdelen is die Git als ondoorzichtig binair bestand opslaat. Een wijziging van één woord verschijnt als gewijzigd bestand zonder leesbare diff, en twee mensen die tegelijk bewerken kunnen hun werk niet samenvoegen.
Markdown is platte tekst, dus elke bewerking is een zichtbare regelwijziging. Het werd ook veel voorspelbaarder in 2014, toen John MacFarlane en anderen CommonMark publiceerden, een nauwkeurige specificatie van de syntaxis die Gruber tien jaar eerder losjes had beschreven. GitHub baseerde zijn eigen GitHub Flavored Markdown-specificatie in 2017 op CommonMark en voegde pipetabellen, takenlijsten en doorhalen toe, die de meeste README's nu gebruiken.
Gaat uw content de andere kant op, Markdown naar een beoordelaar die in Word werkt, gebruik dan Markdown naar DOCX. Voor een webpagina in plaats van een repository behoudt DOCX naar HTML meer van de opmaak.
Zo ziet de Markdown-uitvoer eruit
## Releasechecklist Controleer het volgende voordat u een release tagt: - Tests slagen op **main** - De changelog vermeldt elke gemergde PR | Stap | Eigenaar | | --- | --- | | Build | CI | | Publiceren | Maintainer | 
Waar de geconverteerde Markdown wordt weergegeven
| Organisatie | Vereiste | Bron |
|---|---|---|
| GitHub | Geeft README.md en elk ander .md-bestand in een repository weer met GitHub Flavored Markdown | github.com |
| Hugo | Bouwt pagina's uit .md-contentbestanden met een CommonMark-conforme parser | gohugo.io |
| Jekyll | Maakt van .md-bestanden met front matter pagina's; de engine achter GitHub Pages | jekyllrb.com |
| Docusaurus | Leest .md- en .mdx-bestanden in de docs-map als documentatiepagina's | docusaurus.io |
DOCX
Microsoft Word-document
DOCX is sinds Office 2007 het standaardformaat van Microsoft Word, gebaseerd op de standaard Office Open XML (ECMA-376, ISO/IEC 29500). Het is een ZIP-pakket met XML-bestanden met tekst, stijlen, afbeeldingen, tabellen, opmerkingen en bijgehouden wijzigingen. Het is het meest gebruikte formaat voor bewerkbare documenten op kantoor, op school en bij sollicitaties. De opmaak kan licht verschuiven tussen Word, Google Docs, LibreOffice en Pages, vooral bij complexe opmaak. De meeste tekstverwerkers openen DOCX-bestanden.
- Compressie
- –
- Transparantie
- –
- Animatie
- –
- Geïntroduceerd
- 2007 · Microsoft
MD
Markdown
Markdown is een lichtgewicht opmaaktaal, in 2004 gemaakt door John Gruber. Het gebruikt symbolen in platte tekst, zoals # voor koppen, * voor nadruk en - voor lijsten, die als ruwe tekst leesbaar blijven en netjes naar HTML worden omgezet. Het is de standaard voor README-bestanden, documentatie, wiki's, notitie-apps en veel generatoren voor statische sites. Er bestaan meerdere dialecten, zoals CommonMark en GitHub Flavored Markdown, die verschillen in details zoals tabellen. Elke teksteditor kan .md-bestanden openen.
- Compressie
- –
- Transparantie
- –
- Animatie
- –
- Geïntroduceerd
- 2004 · John Gruber
DOCX wordt naar Markdown geconverteerd wanneer een document in een codeworkflow terechtkomt: een README, een documentatiesite of een kennisbank in Git, waar platte tekst kan worden vergeleken, beoordeeld in pull requests en door veel tools kan worden weergegeven.
Word-functies zonder Markdown-equivalent
Houd hier rekening mee voordat u converteert
- Lettertypen, kleuren en paginaopmaak vervallen; Markdown beschrijft structuur, en het thema van de site bepaalt het uiterlijk
- Bijgehouden wijzigingen en opmerkingen worden niet overgenomen, dus verwerk ze eerst in Word
- Kopteksten, voetteksten en paginanummers passen niet in een .md-bestand
- Tekstvakken en afbeeldingen met tekstomloop worden gewone alinea's en afbeeldingslinks
- Koppen die u handmatig hebt opgemaakt, vet 16 pt in plaats van Kop 2, komen als vette tekst uit de conversie, dus pas eerst echte kopstijlen toe
- Onderstrepen heeft geen Markdown-syntaxis en wordt verwijderd of als HTML behouden
Vragen over DOCX naar Markdown
Welke Markdown-variant volgt de uitvoer van DOCX naar MD?
Koppen, nadruk, lijsten, links en code volgen CommonMark, en tabellen gebruiken de pipe-syntaxis van GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll en Docusaurus geven die combinatie allemaal weer.
Wat gebeurt er met samengevoegde tabelcellen?
Markdown-pipetabellen kennen geen samengevoegde cellen, dus elk samengevoegd gebied wordt weer opgesplitst in losse cellen, met de tekst in de eerste. Bouw complexe tabellen na als HTML in het .md-bestand, of vereenvoudig ze in Word voordat u converteert.
Waar komen de afbeeldingen uit mijn Word-document terecht?
Met Afbeeldingen opnemen aan wordt elke afbeelding als apart bestand in de ZIP opgeslagen, en de Markdown verwijst ernaar met een relatief pad zoals images/figure-1.png. Houd de map naast het .md-bestand als u het verplaatst.
Blijven voetnoten uit Word behouden in Markdown?
CommonMark kent geen syntaxis voor voetnoten, maar GitHub voegde in 2021 voetnoten met [^1] toe en de meeste sitegeneratoren ondersteunen ze. Doet uw renderer dat niet, dan verschijnt de tekst van de voetnoot als gewone alinea's aan het einde.
Kan ik op deze manier Google Docs naar Markdown converteren?
Ja. Kies in Google Docs Bestand > Downloaden > Microsoft Word (.docx) en upload dat bestand hier. Google Docs heeft ook zelf een downloadoptie voor Markdown, die goed werkt voor eenvoudige documenten.
