Šiame straipsnyje mes apžvelgėme konversiją tarp „Markdown“ [1] ir „DOCX“ - nuo 2007 m. Naudojamo „Microsoft Word“ dokumento formato. Jums gali kilti klausimas, kodėl „Markdown“ ir „Asciidoc“ entuziastas (kaip ir aš) užsiima šia byla. Na, bendradarbiavimas su kitų rašytojų grupe gali sukelti situaciją, kai vienas ar daugiau dalyvių reikalauja išvesties formato DOCX. Nieko nenuvilkite ir sužinokite, kokie apribojimai egzistuoja, ir kaip galime pabandyti pradžiuginti visus grupės narius.
Kas yra „Markdown“?
Kaip jau buvo pažymėta „Įvadas į„ Markdown “[2],„ Markdown “tikslas yra paprastas teksto į HTML konversija. Jo idėja buvo padaryti internetinius puslapius, dokumentus ir ypač tinklaraščio įrašus taip pat lengva, kaip rašyti el. Laišką. Nuo šiandien tai yra de facto sinonimas lengvųjų žymėjimo aprašymo kalbų klasei, ir tikslas gali būti vertinamas kaip pasiektas.
Pažymėjimas naudoja paprasto teksto formatavimo sintaksę. Taikant panašų metodą kaip HTML, keli žymekliai jūsų tekste nurodo antraštes, sąrašus, vaizdus ir nuorodas. Kelios žemiau pateiktos eilutės iliustruoja pagrindinį dokumentą, kuriame yra dvi antraštės (1 ir 2 lygiai), dvi pastraipos ir sąrašo aplinka.
## Prancūzija
Tai yra vietų pasirinkimas:
* Paryžius (_Ile de France_)
* Strasbūras (_Alsace_)
Tinkamam vizito planui apie savaitę.
Konversija į DOCX
Norėdami konvertuoti „Markdown“ dokumentą į DOCX, naudokite įrankį „pandoc“ [3]. „Pandoc“ yra „Haskell“ biblioteka ir apibūdina save kaip „universalų dokumentų keitiklį“ arba „Šveicarijos armijos peilį dokumentų konversijai“. Jį galima naudoti įvairiose platformose, tokiose kaip „Linux“, „Microsoft Windows“, „Mac OS X“ ir BSD. „Pandoc“ paprastai įtraukiamas kaip „Linux“ paskirstymų, tokių kaip „Debian GNU / Linux“, „Ubuntu“ ir „CentOS“, paketas.
Paprastas kvietimas atlikti konversiją yra toks:
$ pandoc -o testas.docx testas.mdPirmasis parametras '-o' nurodo išvesties failą, po kurio nurodomas failo pavadinimas ('test.docx '). Failo plėtinys padeda „pandoc“ nustatyti norimą išvesties formatą. Antrasis parametras įvardija įvesties failą - mūsų atveju tai tiesiog „testas“.md '.
Aukščiau pateiktoje ilgoje komandos versijoje yra du parametrai „-f markdown“ ir „-t docx“. Pirmasis sutrumpina terminą „skonis“ ir apibūdina įvesties failo formatą. Antrasis daro tą patį išvesties failui ir sutrumpina „-to“.
Visa komanda yra tokia:
$ pandoc -o testas.docx -f markdown -t docx testas.mdAtidarius konvertuotą failą naudojant „Microsoft Word“, gaunama ši išvestis:
Skirtingiems teksto elementams „Pandoc“ naudoja stiliaus lapus. Tai leidžia vėliau pritaikyti šiuos elementus pagal jūsų poreikius visame dokumente. Naujesnės „Pandoc“ versijos taip pat siūlo ir atvirkščiai - galite konvertuoti DOCX failą į „Markdown“ taip:
$ pandoc -o testas.md testas.docxTada sugeneruotame faile yra šis turinys:
Rekomenduojamos lankytinos vietos Europoje=====================================
Prancūzija
------
Tai vietų pasirinkimas:
- Paryžius (* Ile de France *)
- Strasbūras (* Elzasas *)
Tinkamam vizito planui apie savaitę.
Naudingos komandinės eilutės parinktys
„Pandoc“ parinkčių sąrašas yra gana ilgas. Šie rezultatai padeda pasiekti geresnių rezultatų ir palengvina jūsų gyvenimą:
* '-P' (ilga versija '-preserve-tabs'): išsaugokite skirtukus, o ne paverskite juos tarpais. Tai naudinga kodo blokams su įtraukomis eilutėmis, kurios yra jūsų teksto dalis.
* '-S' (ilga versija '-smart'): sukurkite tipografiškai teisingą išvestį.
Ši parinktis taiso kabutes, brūkšnelius / brūkšnius, taip pat elipses („…“). Po tam tikrų santrumpų, pvz., „P.“.
* '-track-changes = value': nurodo, ką daryti su įterpimais, ištrynimais ir komentarais, kurie sukurti naudojant „Microsoft Word“ funkciją „Stebėti pakeitimus“. Vertė gali būti „sutikti“, „atmesti“ arba visa, norint įtraukti arba pašalinti dokumente atliktus pakeitimus. Rezultatas yra plokščia byla.
Norėdami sužinoti daugiau galimybių, žiūrėkite dokumentaciją ir „Pandoc“ vadovą.
Santrauka
Konversija tarp „Markdown“ ir „DOCX“ nebėra paslaptis. Tai atliekama per kelis veiksmus ir veikia labai gerai. Laimingo įsilaužimo 🙂
Nuorodos ir nuorodos
* [1] Sumažinta kaina
* [2] Frankas Hofmannas: „Markdown“ įvadas
* [3] Pandokas
Padėkos
Autorius norėtų padėkoti Annette Kalbow už pagalbą rengiant straipsnį.