DOCX til Markdown-konverter
Når du flytter dokumentasjon fra Word til et Git-repository, starter du med å gjøre hver .docx om til Markdown. Denne konverteren lager tekst i CommonMark-stil med #-overskrifter, pipe-tabeller og bildelenker, klar til commit.
Dokumentkonverterer
eller slipp PDF, DOC, DOCX …-filer her ·
Maks 95 MB per fil· Opptil 20 filer· Slettes etter 30 minutter
Filene behandles på serverne våre og slettes etter 30 minutter.
150 DPI gjør en A4-side til omtrent 1240 × 1754 px. Bruk 300 for utskrift.
Konverter hele filen eller bare noen sider eller lysbilder (PDF og presentasjoner).
Sider eller lysbilder som skal konverteres, f.eks. 1-3, 5, 8-10.
UTF-8 fungerer for alle språk. Velg UTF-8 med BOM hvis Excel eller Notisblokk på Windows viser ødelagte tegn; eldre tegnkoder bare for gammel programvare.
LF for macOS, Linux og kodeeditorer; CRLF for eldre Windows-programmer som klassisk Notisblokk.
Komma er standard. Bruk semikolon for Excel i land som skriver desimaler med komma (Tyskland, Frankrike, Brasil).
Excel-fil med flere ark: konverter alle (én del eller fil per ark) eller bare det første.
Slik bruker du dette verktøyet
- 1
Last opp Word-filene
Legg til opptil 20 .docx- eller .doc-filer på maks 95 MB hver. Godta eller avvis sporede endringer i Word først, siden Markdown ikke kan vise dem.
- 2
Sjekk tekstinnstillingene
Formatering er satt til Enkel, Tekstkoding til UTF-8 og Linjeskift til LF, kombinasjonen Git og statiske nettstedsgeneratorer forventer. La Ta med bilder stå på for å få bildene i en mappe.
- 3
Konverter og pakk ut
Trykk Konverter til MD. Hvert dokument kommer som en ZIP med .md-filen og bildene; pakk den ut i dokumentasjonsmappen og commit.
Hvordan konverterer jeg et Word-dokument til Markdown?
Last opp .docx-filen og trykk Konverter til MD. Du får en .md-fil med #-overskrifter, lister, lenker og tabeller, pluss bildene i en mappe ved siden av, alt i én ZIP.
DOCX til Markdown for docs-as-code
Team tar i bruk docs-as-code av én grunn: dokumentasjonen ligger da ved siden av koden, går gjennom de samme pull requestene og leveres med samme utgivelse. En .docx ødelegger det, fordi den er en ZIP med XML-deler som Git lagrer som en ugjennomsiktig binærfil. En endring på ett ord vises som en endret fil uten lesbar diff, og to personer som redigerer samtidig kan ikke slå sammen arbeidet sitt.
Markdown er ren tekst, så hver redigering er en synlig linjeendring. Det ble også langt mer forutsigbart i 2014, da John MacFarlane og andre publiserte CommonMark, en presis spesifikasjon av syntaksen Gruber hadde beskrevet løst ti år tidligere. GitHub baserte sin egen GitHub Flavored Markdown-spesifikasjon på CommonMark i 2017, og la til tabeller med pipe-tegn, oppgavelister og gjennomstreking som de fleste README-filer bruker i dag.
Hvis innholdet skal andre veien, Markdown ut til en kollega som jobber i Word, bruk Markdown til DOCX. For en nettside i stedet for et repository beholder DOCX til HTML mer av stilen.
Slik ser Markdown-resultatet ut
## Sjekkliste for utgivelse Før du tagger en utgivelse, kontroller følgende: - Testene består på **main** - Endringsloggen viser alle sammenslåtte PR-er | Steg | Ansvarlig | | --- | --- | | Bygg | CI | | Publisering | Vedlikeholder | 
Hvor den konverterte Markdown-teksten vises
| Organisasjon | Krav | Kilde |
|---|---|---|
| GitHub | Gjengir README.md og alle .md-filer i et repository med GitHub Flavored Markdown | github.com |
| Hugo | Bygger sider fra .md-innholdsfiler med en CommonMark-kompatibel parser | gohugo.io |
| Jekyll | Gjør .md-filer med front matter om til sider; motoren bak GitHub Pages | jekyllrb.com |
| Docusaurus | Leser .md- og .mdx-filer i docs-mappen som dokumentasjonssider | docusaurus.io |
DOCX
Microsoft Word-dokument
DOCX er Microsoft Words standard dokumentformat siden Office 2007, basert på standarden Office Open XML (ECMA-376, ISO/IEC 29500). Det er en ZIP-pakke med XML-filer som inneholder tekst, stiler, bilder, tabeller, kommentarer og sporede endringer. Det er det vanligste formatet for redigerbare dokumenter på kontor, i skolen og i jobbsøknader. Utseendet kan forskyves litt mellom Word, Google Docs, LibreOffice og Pages, særlig ved kompleks formatering. De fleste tekstbehandlere åpner DOCX-filer.
- Komprimering
- –
- Gjennomsiktighet
- –
- Animasjon
- –
- Introdusert
- 2007 · Microsoft
MD
Markdown
Markdown er en lett markeringssyntaks laget av John Gruber i 2004. Den bruker symboler i ren tekst, som # for overskrifter, * for utheving og - for lister, som er lesbare som rå tekst og konverteres rent til HTML. Det er standarden for README-filer, dokumentasjon, wikier, notatapper og mange statiske nettstedsgeneratorer. Det finnes flere dialekter, som CommonMark og GitHub Flavored Markdown, som skiller seg i detaljer som tabeller. Alle tekstredigerere kan åpne .md-filer.
- Komprimering
- –
- Gjennomsiktighet
- –
- Animasjon
- –
- Introdusert
- 2004 · John Gruber
DOCX konverteres til Markdown når et dokument skal inn i en kodearbeidsflyt: en README, et dokumentasjonsnettsted eller en kunnskapsbase i Git, der ren tekst kan sammenlignes, gjennomgås i pull requests og gjengis av mange verktøy.
Word-funksjoner uten tilsvarende i Markdown
Ta høyde for dette før du konverterer
- Skrifter, farger og sideoppsett fjernes; Markdown beskriver struktur, og nettstedets tema bestemmer utseendet
- Sporede endringer og kommentarer følger ikke med, så løs dem i Word først
- Topptekster, bunntekster og sidetall har ingen plass i en .md-fil
- Tekstbokser og bilder med tekstbryting blir vanlige avsnitt og bildelenker
- Overskrifter du har formatert for hånd, fet 16 pt i stedet for Overskrift 2, blir fet tekst, så bruk ekte overskriftsstiler først
- Understreking har ingen Markdown-syntaks og fjernes eller beholdes som HTML
Spørsmål om DOCX til Markdown
Hvilken Markdown-variant følger DOCX til MD-resultatet?
Overskrifter, utheving, lister, lenker og kode følger CommonMark, og tabeller bruker pipe-syntaksen fra GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll og Docusaurus gjengir alle denne kombinasjonen.
Hva skjer med sammenslåtte tabellceller?
Markdown-tabeller med pipe-tegn har ingen sammenslåtte celler, så hvert sammenslått område deles opp i enkeltceller med teksten i den første. Bygg komplekse tabeller på nytt som HTML inne i .md-filen, eller forenkle dem i Word før konverteringen.
Hvor havner bildene fra Word-dokumentet mitt?
Når Ta med bilder er på, lagres hvert bilde som en egen fil i ZIP-en, og Markdown lenker til det med en relativ sti som images/figure-1.png. Behold mappen ved siden av .md-filen når du flytter den.
Blir fotnoter fra Word bevart i Markdown?
CommonMark har ingen syntaks for fotnoter, men GitHub la til [^1]-fotnoter i 2021, og de fleste nettstedsgeneratorer støtter dem. Hvis gjengiveren din ikke gjør det, vises notatteksten som vanlige avsnitt til slutt.
Kan jeg konvertere Google Docs til Markdown på denne måten?
Ja. I Google Docs velger du Fil > Last ned > Microsoft Word (.docx), og laster deretter opp den filen her. Google Docs har også et eget alternativ for nedlasting som Markdown, som fungerer godt for enkle dokumenter.
