UltKit

Convertor DOCX în Markdown

Mutarea documentației din Word într-un depozit Git începe cu transformarea fiecărui fișier .docx în Markdown. Acest convertor generează text în stil CommonMark, cu titluri #, tabele cu bare verticale și linkuri către imagini, gata de commit.

Convertor de documente

sau trage Fișiere PDF, DOC, DOCX … aici ·

Maximum 95 MB per fișier· Până la 20 fișiere· Șterse după 30 minute

Rezultat

Fișierele sunt procesate pe serverele noastre și șterse după 30 minute.

Cum se folosește acest instrument

  1. 1

    Încărcați fișierele Word

    Adăugați până la 20 de fișiere .docx sau .doc, de până la 95 MB fiecare. Acceptați sau respingeți mai întâi modificările urmărite în Word, deoarece Markdown nu le poate afișa.

  2. 2

    Verificați opțiunile de text

    Formatare este pe Simplu, Codificarea textului pe UTF-8 și Sfârșit de rând pe LF, combinația pe care o așteaptă Git și generatoarele de site-uri statice. Lăsați activată opțiunea Include imaginile ca să primiți pozele într-un dosar.

  3. 3

    Convertiți și dezarhivați

    Apăsați Convertește în MD. Fiecare document sosește ca un ZIP cu fișierul .md și imaginile sale; dezarhivați-l în dosarul de documentație și faceți commit.

Răspuns

Cum convertesc un document Word în Markdown?

Încărcați fișierul .docx și apăsați Convertește în MD. Primiți un fișier .md cu titluri #, liste, linkuri și tabele, plus imaginile într-un dosar alăturat, totul într-un singur ZIP.

DOCX în Markdown pentru docs-as-code

Echipele adoptă docs-as-code dintr-un singur motiv: documentația stă lângă cod, trece prin aceleași pull request-uri și apare în aceeași versiune. Un .docx strică asta, pentru că este un ZIP cu părți XML pe care Git le stochează ca binar opac. O schimbare de un cuvânt apare ca fișier modificat, fără un diff lizibil, iar două persoane care editează simultan nu își pot îmbina munca.

Markdown este text simplu, deci fiecare modificare este o schimbare vizibilă de rând. A devenit mult mai previzibil în 2014, când John MacFarlane și alții au publicat CommonMark, o specificație precisă a sintaxei pe care Gruber o descrisese vag cu zece ani înainte. GitHub și-a bazat în 2017 specificația GitHub Flavored Markdown pe CommonMark, adăugând tabelele cu bare verticale, listele de sarcini și textul tăiat pe care le folosesc azi majoritatea fișierelor README.

Dacă conținutul merge în sens invers, din Markdown către un recenzent care lucrează în Word, folosiți Markdown în DOCX. Pentru o pagină web, nu pentru un depozit de cod, DOCX în HTML păstrează mai mult din stil.

Cum arată rezultatul în Markdown

O secțiune Word cu titlu, listă și tabel, după conversie
## Listă de verificare pentru lansare

Înainte de a eticheta o lansare, confirmați următoarele:

- Testele trec pe **main**
- Jurnalul de modificări listează fiecare PR îmbinat

| Pas | Responsabil |
| --- | --- |
| Build | CI |
| Publicare | Mentenanță |

![Fluxul lansării](images/figure-1.png)

Unde va fi afișat Markdown-ul convertit

Platforme care citesc direct fișiere Markdown
OrganizațieCerințăSursă
GitHubAfișează README.md și orice fișier .md dintr-un depozit folosind GitHub Flavored Markdowngithub.com
HugoConstruiește pagini din fișiere de conținut .md cu un parser conform CommonMarkgohugo.io
JekyllTransformă fișierele .md cu front matter în pagini; motorul din spatele GitHub Pagesjekyllrb.com
DocusaurusCitește fișierele .md și .mdx din dosarul docs ca pagini de documentațiedocusaurus.io

DOCX

Document Microsoft Word

DOCX este formatul implicit de document Microsoft Word din Office 2007, bazat pe standardul Office Open XML (ECMA-376, ISO/IEC 29500). Este un pachet ZIP de fișiere XML ce conțin text, stiluri, imagini, tabele, comentarii și modificări urmărite. Este cel mai răspândit format pentru documente editabile în birouri, școli și candidaturi la joburi. Aspectul se poate modifica ușor între Word, Google Docs, LibreOffice și Pages, mai ales în cazul formatărilor complexe. Majoritatea procesoarelor de text deschid fișiere DOCX.

Compresie
–
Transparență
–
Animație
–
Introdus în
2007 · Microsoft
Convertor DOCX

MD

Markdown

Markdown este o sintaxă de marcare ușoară, creată de John Gruber în 2004. Folosește simboluri din text simplu, precum # pentru titluri, * pentru accentuare și - pentru liste, care rămân lizibile ca text brut și se convertesc curat în HTML. Este standardul pentru fișiere README, documentație, wiki-uri, aplicații de notițe și multe generatoare de site-uri statice. Există mai multe dialecte, precum CommonMark și GitHub Flavored Markdown, care diferă în detalii precum tabelele. Orice editor de text poate deschide fișiere .md.

Compresie
–
Transparență
–
Animație
–
Introdus în
2004 · John Gruber
Convertor MD

DOCX se convertește în Markdown când un document intră într-un flux de lucru de cod: un README, un site de documentație sau o bază de cunoștințe ținută în Git, unde textul simplu poate fi comparat, revizuit în pull request-uri și randat de multe instrumente.

Funcții Word fără echivalent în Markdown

Pregătiți-vă pentru acestea înainte de conversie

  • Fonturile, culorile și aspectul paginii se pierd; Markdown descrie structura, iar tema site-ului decide aspectul
  • Modificările urmărite și comentariile nu se transferă, deci rezolvați-le mai întâi în Word
  • Antetele, subsolurile și numerele de pagină nu au loc într-un fișier .md
  • Casetele de text și imaginile încadrate devin paragrafe obișnuite și linkuri de imagine
  • Titlurile formatate manual, aldine de 16 pt în loc de Titlu 2, ies ca text aldin, deci aplicați mai întâi stiluri reale de titlu
  • Sublinierea nu are sintaxă în Markdown și este eliminată sau păstrată ca HTML

Întrebări despre DOCX în Markdown

Ce variantă de Markdown urmează rezultatul DOCX în MD?

Titlurile, accentuările, listele, linkurile și codul urmează CommonMark, iar tabelele folosesc sintaxa cu bare verticale din GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll și Docusaurus afișează toate această combinație.

Ce se întâmplă cu celulele de tabel îmbinate?

Tabelele Markdown cu bare verticale nu au celule îmbinate, așa că fiecare zonă îmbinată este împărțită la loc în celule individuale, cu textul în prima. Refaceți tabelele complexe ca HTML în interiorul fișierului .md sau simplificați-le în Word înainte de conversie.

Unde ajung imaginile din documentul Word?

Cu Include imaginile activat, fiecare imagine este salvată ca fișier separat în ZIP, iar Markdown trimite la ea printr-o cale relativă, de exemplu images/figure-1.png. Păstrați dosarul lângă fișierul .md când îl mutați.

Se păstrează notele de subsol din Word în Markdown?

CommonMark nu are sintaxă pentru note de subsol, dar GitHub a adăugat notele [^1] în 2021, iar majoritatea generatoarelor de site-uri le acceptă. Dacă programul dvs. de randare nu le acceptă, textul notei apare ca paragrafe simple la final.

Pot converti astfel Google Docs în Markdown?

Da. În Google Docs alegeți Fișier > Descarcă > Microsoft Word (.docx), apoi încărcați aici fișierul respectiv. Google Docs oferă și propria opțiune de descărcare Markdown, care funcționează bine pentru documente simple.