UltKit

Konvertera DOCX till Markdown

Att flytta dokumentation från Word till ett Git-repo börjar med att varje .docx blir Markdown. Konverteraren skriver text i CommonMark-stil med #-rubriker, tabeller med lodstreck och bildlänkar, redo att committa.

Dokumentkonverterare

eller släpp PDF, DOC, DOCX …-filer här ·

Max 95 MB per fil· Upp till 20 filer· Raderas efter 30 minuter

Utdata

Filerna bearbetas på våra servrar och raderas efter 30 minuter.

Så använder du verktyget

  1. 1

    Ladda upp Word-filerna

    Lägg till upp till 20 .docx- eller .doc-filer, högst 95 MB per fil. Godkänn eller avvisa spårade ändringar i Word först, eftersom Markdown inte kan visa dem.

  2. 2

    Kontrollera textalternativen

    Formatering är inställd på Enkel, Textkodning på UTF-8 och Radslut på LF, den kombination som Git och statiska webbplatsgeneratorer förväntar sig. Låt Ta med bilder vara på för att få bilderna i en mapp.

  3. 3

    Konvertera och packa upp

    Tryck på Konvertera till MD. Varje dokument levereras som en ZIP med .md-filen och dess bilder. Packa upp den i din dokumentationsmapp och checka in.

Svar

Hur konverterar jag ett Word-dokument till Markdown?

Ladda upp .docx-filen och tryck på Konvertera till MD. Du får en .md-fil med #-rubriker, listor, länkar och tabeller, plus bilderna i en mapp bredvid, allt i en och samma ZIP.

DOCX till Markdown för docs-as-code

Team väljer docs-as-code av en enda anledning: dokumentationen ligger då bredvid koden, går igenom samma pull requests och levereras med samma release. En .docx förstör det, eftersom den är en ZIP med XML-delar som Git lagrar som en ogenomskinlig binärfil. En ändring på ett enda ord visas som en ändrad fil utan läsbar diff, och två personer som redigerar samtidigt kan inte slå ihop sitt arbete.

Markdown är ren text, så varje redigering syns som en radändring. Det blev också mycket mer förutsägbart 2014, när John MacFarlane med flera publicerade CommonMark, en exakt specifikation av den syntax som Gruber hade beskrivit löst tio år tidigare. GitHub baserade sin egen specifikation GitHub Flavored Markdown på CommonMark 2017 och lade till de tabeller med pipe-tecken, uppgiftslistor och genomstrykning som de flesta README-filer använder i dag.

Om innehållet ska åt andra hållet, Markdown till en granskare som arbetar i Word, använd Markdown till DOCX. För en webbsida snarare än ett repository behåller DOCX till HTML mer av formateringen.

Så ser Markdown-resultatet ut

Ett Word-avsnitt med rubrik, lista och tabell, efter konvertering
## Checklista inför release

Innan en release taggas, kontrollera följande:

- Testerna går igenom på **main**
- Ändringsloggen listar varje sammanfogad PR

| Steg | Ansvarig |
| --- | --- |
| Bygge | CI |
| Publicering | Förvaltare |

![Releaseflöde](images/figure-1.png)

Var den konverterade Markdown-texten visas

Plattformar som läser Markdown-filer direkt
OrganisationKravKälla
GitHubRenderar README.md och alla andra .md-filer i ett repository med GitHub Flavored Markdowngithub.com
HugoBygger sidor från .md-innehållsfiler med en CommonMark-kompatibel parsergohugo.io
JekyllGör om .md-filer med front matter till sidor; motorn bakom GitHub Pagesjekyllrb.com
DocusaurusLäser .md- och .mdx-filer i sin docs-mapp som dokumentationssidordocusaurus.io

DOCX

Microsoft Word-dokument

DOCX är Microsoft Words standardformat för dokument sedan Office 2007 och bygger på standarden Office Open XML (ECMA-376, ISO/IEC 29500). Det är ett ZIP-paket med XML-filer som innehåller text, format, bilder, tabeller, kommentarer och spårade ändringar. Det är det vanligaste formatet för redigerbara dokument på kontor, i skolor och vid jobbansökningar. Layouten kan skilja sig något mellan Word, Google Docs, LibreOffice och Pages, särskilt vid komplex formatering. De flesta ordbehandlare öppnar DOCX-filer.

Komprimering
–
Transparens
–
Animation
–
Introducerades
2007 · Microsoft
DOCX-omvandlare

MD

Markdown

Markdown är en lättviktig syntax för märkning som John Gruber skapade 2004. Den använder symboler i ren text, som # för rubriker, * för betoning och - för listor, som förblir läsbara som råtext och konverteras rent till HTML. Det är standard för README-filer, dokumentation, wikis, anteckningsappar och många generatorer för statiska webbplatser. Det finns flera dialekter, som CommonMark och GitHub Flavored Markdown, som skiljer sig i detaljer som tabeller. Vilken textredigerare som helst kan öppna .md-filer.

Komprimering
–
Transparens
–
Animation
–
Introducerades
2004 · John Gruber
MD-omvandlare

DOCX konverteras till Markdown när ett dokument flyttas in i ett kodflöde: en README, en dokumentationssajt eller en kunskapsbas i Git, där ren text kan jämföras, granskas i pull requests och renderas av många verktyg.

Word-funktioner som saknar motsvarighet i Markdown

Planera för detta innan du konverterar

  • Typsnitt, färger och sidlayout tas bort; Markdown beskriver struktur, och webbplatsens tema bestämmer utseendet
  • Spårade ändringar och kommentarer följer inte med, så lös dem i Word först
  • Sidhuvuden, sidfötter och sidnummer har ingen plats i en .md-fil
  • Textrutor och bilder med textomflöde blir vanliga stycken och bildlänkar
  • Rubriker du formaterat för hand, fet stil 16 pt i stället för Rubrik 2, blir fet text, så använd riktiga rubrikformat först
  • Understrykning saknar syntax i Markdown och tas bort eller behålls som HTML

Frågor om DOCX till Markdown

Vilken Markdown-variant följer konverteringen från DOCX till MD?

Rubriker, betoning, listor, länkar och kod följer CommonMark, och tabeller använder pipe-syntaxen från GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll och Docusaurus renderar alla den kombinationen.

Vad händer med sammanslagna tabellceller?

Markdown-tabeller med pipe-tecken saknar sammanslagna celler, så varje sammanslaget område delas upp i enskilda celler med texten i den första. Bygg om komplexa tabeller som HTML inuti .md-filen, eller förenkla dem i Word innan du konverterar.

Var hamnar bilderna från mitt Word-dokument?

Med Ta med bilder påslaget sparas varje bild som en separat fil i ZIP-filen, och Markdown länkar till den med en relativ sökväg som images/figure-1.png. Låt mappen ligga bredvid .md-filen när du flyttar den.

Följer fotnoter från Word med till Markdown?

CommonMark har ingen syntax för fotnoter, men GitHub lade till fotnoter med [^1] 2021 och de flesta webbplatsgeneratorer stöder dem. Om din renderare inte gör det visas fotnotstexten som vanliga stycken i slutet.

Kan jag konvertera Google Docs till Markdown på det här sättet?

Ja. I Google Docs väljer du Arkiv > Ladda ner > Microsoft Word (.docx) och laddar sedan upp den filen här. Google Docs har även ett eget alternativ för nedladdning som Markdown, som fungerar bra för enkla dokument.