UltKit

Kibadilishaji DOCX kuwa Markdown

Kuhamisha nyaraka za maelezo kutoka Word kwenda hazina ya Git huanza kwa kubadilisha kila faili ya .docx kuwa Markdown. Kibadilishaji hiki huandika maandishi ya mtindo wa CommonMark yenye vichwa vya #, majedwali ya mistari wima na viungo vya picha, tayari kwa commit.

Kibadilishaji cha Hati

au buruta Faili za PDF, DOC, DOCX … hapa ·

Hadi MB 95 kwa faili· Hadi faili 20· Hufutwa baada ya dakika 30

Matokeo

Faili huchakatwa kwenye seva zetu na kufutwa baada ya dakika 30.

Jinsi ya kutumia zana hii

  1. 1

    Pakia faili za Word

    Ongeza hadi faili 20 za .docx au .doc, kila moja hadi 95 MB. Kwanza kubali au kataa mabadiliko yaliyofuatiliwa katika Word, kwa sababu Markdown haina njia ya kuyaonyesha.

  2. 2

    Kagua chaguo za maandishi

    Uumbizaji umewekwa kuwa Rahisi, Usimbaji wa maandishi kuwa UTF-8 na Miisho ya mistari kuwa LF, mchanganyiko ambao Git na zana za kutengeneza tovuti tuli zinatarajia. Acha Jumuisha picha ikiwa imewashwa ili upate picha kwenye folda.

  3. 3

    Badilisha na ufungue faili

    Bonyeza Badilisha kuwa MD. Kila hati inakuja kama ZIP yenye faili ya .md na picha zake; ifungue kwenye folda yako ya nyaraka kisha ifanye commit.

Jibu

Ninawezaje kubadilisha hati ya Word kuwa Markdown?

Pakia .docx kisha bonyeza Badilisha kuwa MD. Unapata faili ya .md yenye vichwa vya #, orodha, viungo na majedwali, pamoja na picha kwenye folda iliyo kando yake, vyote ndani ya ZIP moja.

DOCX kuwa Markdown kwa hati-kama-msimbo

Timu hutumia docs-as-code kwa sababu moja: nyaraka huishi karibu na msimbo, hupitia pull request zilezile na hutolewa na toleo lilelile. .docx huvunja hilo, kwa sababu ni ZIP ya sehemu za XML ambazo Git huhifadhi kama faili ya binary isiyosomeka. Badiliko la neno moja huonekana kama faili iliyobadilika bila tofauti inayosomeka, na watu wawili wanaohariri kwa wakati mmoja hawawezi kuunganisha kazi yao.

Markdown ni maandishi matupu, kwa hiyo kila badiliko ni mstari unaoonekana. Pia ilitabirika zaidi mwaka 2014, John MacFarlane na wengine walipochapisha CommonMark, vipimo sahihi vya sintaksia ambayo Gruber alieleza kwa ulegevu miaka kumi kabla. GitHub ilijenga vipimo vyake vya GitHub Flavored Markdown juu ya CommonMark mwaka 2017, ikiongeza majedwali ya mistari wima, orodha za kazi na mstari wa kufuta ambavyo README nyingi hutumia leo.

Kama maudhui yako yanakwenda upande mwingine, yaani Markdown kwa mkaguzi anayefanya kazi katika Word, tumia Markdown kuwa DOCX. Kwa ukurasa wa wavuti badala ya hifadhi, DOCX kuwa HTML huhifadhi mtindo zaidi.

Jinsi matokeo ya Markdown yanavyoonekana

Sehemu ya Word yenye kichwa, orodha na jedwali, baada ya kubadilisha
## Orodha ya ukaguzi wa toleo

Kabla ya kuweka tagi ya toleo, thibitisha yafuatayo:

- Majaribio yanapita kwenye **main**
- Changelog inaorodhesha kila PR iliyounganishwa

| Hatua | Mmiliki |
| --- | --- |
| Build | CI |
| Chapisha | Mtunzaji |

![Mtiririko wa toleo](images/figure-1.png)

Mahali ambapo Markdown iliyobadilishwa itaonyeshwa

Majukwaa yanayosoma faili za Markdown moja kwa moja
ShirikaShartiChanzo
GitHubHuonyesha README.md na faili yoyote ya .md kwenye hifadhi kwa kutumia GitHub Flavored Markdowngithub.com
HugoHujenga kurasa kutoka faili za maudhui za .md kwa kichanganuzi kinachofuata CommonMarkgohugo.io
JekyllHugeuza faili za .md zenye front matter kuwa kurasa; ndiyo injini nyuma ya GitHub Pagesjekyllrb.com
DocusaurusHusoma faili za .md na .mdx katika folda yake ya nyaraka kama kurasa za nyarakadocusaurus.io

DOCX

Hati ya Microsoft Word

DOCX ni umbizo chaguomsingi la hati la Microsoft Word tangu Office 2007, linalotegemea kiwango cha Office Open XML (ECMA-376, ISO/IEC 29500). Ni kifurushi cha ZIP cha faili za XML kilicho na maandishi, mitindo, picha, majedwali, maoni na mabadiliko yaliyofuatiliwa. Ndilo umbizo linalotumika zaidi kwa hati zinazohaririwa ofisini, shuleni na katika maombi ya kazi. Mpangilio unaweza kubadilika kidogo kati ya Word, Google Docs, LibreOffice na Pages, hasa kwa uumbizaji tata. Vichakataji maandishi vingi hufungua faili za DOCX.

Ubanaji
–
Uwazi
–
Uhuishaji
–
Mwaka ulioanzishwa
2007 · Microsoft
Kigeuzi cha DOCX

MD

Markdown

Markdown ni sintaksia nyepesi ya alama iliyoundwa na John Gruber mwaka 2004. Hutumia alama za maandishi matupu, kama # kwa vichwa, * kwa msisitizo na - kwa orodha, zinazobaki kusomeka kama maandishi ghafi na kugeuka vizuri kuwa HTML. Ni kiwango cha faili za README, nyaraka, wiki, programu za madokezo na viunda tovuti tuli vingi. Kuna lahaja kadhaa, kama CommonMark na GitHub Flavored Markdown, zinazotofautiana katika maelezo kama majedwali. Kihariri chochote cha maandishi kinaweza kufungua faili za .md.

Ubanaji
–
Uwazi
–
Uhuishaji
–
Mwaka ulioanzishwa
2004 · John Gruber
Kigeuzi cha MD

DOCX hubadilishwa kuwa Markdown hati inapohamia kwenye mtiririko wa msimbo: README, tovuti ya nyaraka au hifadhi ya maarifa iliyo kwenye Git, ambapo maandishi matupu yanaweza kulinganishwa, kukaguliwa kwenye pull request na kuonyeshwa na zana nyingi.

Vipengele vya Word visivyo na kisawe katika Markdown

Jiandae kwa haya kabla ya kubadilisha

  • Fonti, rangi na mpangilio wa ukurasa huondolewa; Markdown inaeleza muundo, na mandhari ya tovuti huamua mwonekano
  • Mabadiliko yaliyofuatiliwa na maoni hayahamishwi, kwa hiyo yatatue kwanza katika Word
  • Vichwa vya juu, vichwa vya chini na namba za kurasa havina nafasi kwenye faili ya .md
  • Visanduku vya maandishi na picha zilizozungukwa na maandishi huwa aya za kawaida na viungo vya picha
  • Vichwa ulivyoviumbiza kwa mkono, herufi nzito 16 pt badala ya Heading 2, hutoka kama maandishi mazito, kwa hiyo tumia mitindo halisi ya vichwa kwanza
  • Mstari chini ya maandishi hauna sintaksia ya Markdown na huondolewa au kubaki kama HTML

Maswali kuhusu DOCX kuwa Markdown

Matokeo ya DOCX kuwa MD hufuata aina gani ya Markdown?

Vichwa, msisitizo, orodha, viungo na msimbo hufuata CommonMark, na majedwali hutumia sintaksia ya mistari wima kutoka GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll na Docusaurus zote huonyesha mchanganyiko huo.

Nini hutokea kwa visanduku vya jedwali vilivyounganishwa?

Majedwali ya Markdown hayana seli zilizounganishwa, kwa hiyo kila eneo lililounganishwa hugawanywa tena kuwa seli moja moja, na maandishi yakiwa kwenye ya kwanza. Jenga upya majedwali tata kama HTML ndani ya .md, au yarahisishe katika Word kabla ya kubadilisha.

Picha za hati yangu ya Word huenda wapi?

Ukiwasha Jumuisha picha, kila picha huhifadhiwa kama faili tofauti ndani ya ZIP, na Markdown huiunganisha kwa njia ya kiasi kama images/figure-1.png. Weka folda hiyo karibu na faili ya .md unapoihamisha.

Je, tanbihi za Word hubaki katika Markdown?

CommonMark haina sintaksia ya tanbihi, lakini GitHub iliongeza tanbihi za [^1] mwaka 2021 na vizalisha tovuti vingi huziunga mkono. Kama kionyeshi chako hakiziungi mkono, maandishi ya tanbihi huonekana kama aya za kawaida mwishoni.

Je, ninaweza kubadilisha Google Docs kuwa Markdown kwa njia hii?

Ndiyo. Katika Google Docs chagua Faili > Pakua > Microsoft Word (.docx), kisha pakia faili hiyo hapa. Google Docs pia ina chaguo lake la kupakua Markdown, linalofaa kwa hati rahisi.