UltKit

DOCX na Markdown-omskakelaar

Om dokumentasie uit Word na 'n Git-bewaarplek te skuif, begin u deur elke .docx na Markdown om te skakel. Hierdie omskakelaar skryf teks in CommonMark-styl met #-opskrifte, pyptabelle en beeldskakels, gereed om te commit.

Dokumentomskakelaar

of los PDF, DOC, DOCX …-lêers hier ·

Maks. 95 MB per lêer· Tot 20 lêers· Uitgevee na 30 minute

Uitvoer

Lêers word op ons bedieners verwerk en na 30 minute uitgevee.

Hoe om hierdie nutsding te gebruik

  1. 1

    Laai die Word-lêers op

    Voeg tot 20 .docx- of .doc-lêers by, elk tot 95 MB. Aanvaar of verwerp eers opgespoorde veranderinge in Word, want Markdown kan dit nie wys nie.

  2. 2

    Gaan die teksopsies na

    Formatering staan op Eenvoudig, Tekskodering op UTF-8 en Reëleindes op LF, die kombinasie wat Git en statiese werfgenerators verwag. Hou Sluit beelde in aan om prente in 'n vouer te kry.

  3. 3

    Skakel om en pak uit

    Druk Skakel om na MD. Elke dokument kom as 'n ZIP met die .md-lêer en sy beelde; pak dit uit in jou docs-vouer en pleeg dit.

Antwoord

Hoe skakel ek 'n Word-dokument na Markdown om?

Laai die .docx op en druk Skakel om na MD. Jy kry 'n .md-lêer met #-opskrifte, lyste, skakels en tabelle, plus die beelde in 'n vouer daarnaas, alles in een ZIP.

DOCX na Markdown vir docs-as-code

Spanne neem docs-as-code om een rede aan: dokumentasie leef dan langs die kode, gaan deur dieselfde pull requests en word met dieselfde vrystelling gelewer. 'n .docx breek dit, want dit is 'n ZIP van XML-dele wat Git as 'n ondeursigtige binêre lêer stoor. 'n Een-woord-verandering wys as 'n veranderde lêer sonder leesbare verskil, en twee mense wat gelyktydig wysig, kan nie hul werk saamvoeg nie.

Markdown is gewone teks, so elke wysiging is 'n sigbare reëlverandering. Dit het ook baie voorspelbaarder geword in 2014, toe John MacFarlane en ander CommonMark gepubliseer het, 'n presiese spesifikasie van die sintaksis wat Gruber tien jaar vroeër losweg beskryf het. GitHub het in 2017 sy eie GitHub Flavored Markdown-spesifikasie op CommonMark gebaseer en die pyptabelle, taaklyste en deurhaling bygevoeg wat die meeste README's vandag gebruik.

As jou inhoud die ander kant toe gaan, Markdown uit na 'n nagaan-persoon wat in Word werk, gebruik Markdown na DOCX. Vir 'n webblad eerder as 'n bewaarplek behou DOCX na HTML meer van die styling.

Hoe die Markdown-uitvoer lyk

'n Word-afdeling met 'n opskrif, 'n lys en 'n tabel, ná omskakeling
## Kontrolelys vir vrystelling

Bevestig die volgende voordat 'n vrystelling gemerk word:

- Toetse slaag op **main**
- Die veranderingslog lys elke saamgevoegde PR

| Stap | Eienaar |
| --- | --- |
| Bou | CI |
| Publiseer | Onderhouer |

![Vrystellingsvloei](images/figure-1.png)

Waar die omgeskakelde Markdown vertoon sal word

Platforms wat Markdown-lêers direk lees
OrganisasieVereisteBron
GitHubVertoon README.md en enige .md-lêer in 'n bewaarplek met GitHub Flavored Markdowngithub.com
HugoBou bladsye uit .md-inhoudlêers met 'n CommonMark-versoenbare ontledergohugo.io
JekyllMaak van .md-lêers met front matter bladsye; die enjin agter GitHub Pagesjekyllrb.com
DocusaurusLees .md- en .mdx-lêers in sy docs-vouer as dokumentasiebladsyedocusaurus.io

DOCX

Microsoft Word-dokument

DOCX is Microsoft Word se verstek dokumentformaat sedert Office 2007, gebaseer op die Office Open XML-standaard (ECMA-376, ISO/IEC 29500). Dit is 'n ZIP-pakket XML-lêers met teks, style, beelde, tabelle, opmerkings en nagespeurde veranderinge. Dit is die algemeenste formaat vir wysigbare dokumente in kantore, skole en werksaansoeke. Uitleg kan effens verskuif tussen Word, Google Docs, LibreOffice en Pages, veral by komplekse formatering. Die meeste woordverwerkers maak DOCX-lêers oop.

Kompressie
–
Deursigtigheid
–
Animasie
–
Bekendgestel
2007 · Microsoft
DOCX-omskakelaar

MD

Markdown

Markdown is 'n ligte opmaaksintaksis wat in 2004 deur John Gruber geskep is. Dit gebruik platteteks-simbole, soos # vir opskrifte, * vir beklemtoning en - vir lyste, wat as rou teks leesbaar bly en netjies na HTML omgeskakel word. Dit is die standaard vir README-lêers, dokumentasie, wiki's, notaprogramme en baie statiese webwerfgenerators. Daar is verskeie dialekte, soos CommonMark en GitHub Flavored Markdown, wat in besonderhede soos tabelle verskil. Enige teksredigeerder kan .md-lêers oopmaak.

Kompressie
–
Deursigtigheid
–
Animasie
–
Bekendgestel
2004 · John Gruber
MD-omskakelaar

DOCX word na Markdown omgeskakel wanneer 'n dokument in 'n kode-werkvloei beweeg: 'n README, 'n docs-werf of 'n kennisbasis in Git, waar gewone teks vergelyk, in pull requests hersien en deur baie gereedskap vertoon kan word.

Word-funksies sonder 'n Markdown-ekwivalent

Beplan hiervoor voordat u omskakel

  • Lettertipes, kleure en bladsyuitleg word weggelaat; Markdown beskryf struktuur, en die werf se tema bepaal die voorkoms
  • Opgespoorde veranderinge en opmerkings word nie oorgedra nie, so los dit eers in Word op
  • Kopstukke, voetstukke en bladsynommers het geen plek in 'n .md-lêer nie
  • Tekskassies en beelde met teksomvloei word gewone paragrawe en beeldskakels
  • Opskrifte wat jy met die hand geformateer het, vetgedrukte 16 pt in plaas van Heading 2, kom uit as vetgedrukte teks, so pas eers regte opskrifstyle toe
  • Onderstreping het geen Markdown-sintaksis nie en word verwyder of as HTML behou

Vrae oor DOCX na Markdown

Watter Markdown-variant volg die DOCX na MD-uitvoer?

Opskrifte, beklemtoning, lyste, skakels en kode volg CommonMark, en tabelle gebruik die pyp-sintaksis van GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll en Docusaurus vertoon almal hierdie kombinasie.

Wat gebeur met saamgevoegde tabelselle?

Markdown-pyptabelle het nie saamgevoegde selle nie, so elke saamgevoegde area word weer in individuele selle verdeel, met die teks in die eerste een. Bou komplekse tabelle as HTML binne die .md weer op, of vereenvoudig hulle in Word voordat jy omskakel.

Waarheen gaan die prente uit my Word-dokument?

Met Sluit beelde in aan, word elke prent as 'n aparte lêer in die ZIP gestoor, en die Markdown skakel daarheen met 'n relatiewe pad soos images/figure-1.png. Hou die vouer langs die .md-lêer wanneer jy dit skuif.

Bly Word-voetnote in Markdown behoue?

CommonMark het nie voetnoot-sintaksis nie, maar GitHub het in 2021 [^1]-voetnote bygevoeg en die meeste werfgenerators ondersteun dit. As jou vertoner dit nie doen nie, verskyn die notateks as gewone paragrawe aan die einde.

Kan ek Google Docs só na Markdown omskakel?

Ja. Kies in Google Docs File > Download > Microsoft Word (.docx), en laai dan daardie lêer hier op. Google Docs bied ook sy eie Markdown-aflaaiopsie, wat goed werk vir eenvoudige dokumente.