Phenquestions
În acest articol vom analiza conversia dintre Markdown [1] și DOCX - formatul de document nativ al Microsoft Word care este utilizat din 2007. S-ar putea să vă întrebați de ce un pasionat de Markdown și Asciidoc (ca mine) se ocupă de acest caz. Ei bine, colaborarea cu un grup de alți scriitori poate duce la o situație, în timp ce unul sau mai mulți participanți solicită DOCX ca format de ieșire. Nu lăsați pe nimeni în jos și aflați în schimb ce limitări există și cum putem încerca să îi bucurăm pe toți membrii grupului.
Ce este Markdown?
După cum sa subliniat deja în „O introducere în Markdown” [2], intenția pentru Markdown este o simplă conversie text în HTML. Ideea din spatele acesteia a fost de a face scrierea de pagini web, documentație și în special intrări de blog la fel de ușoară ca scrierea unui e-mail. Începând de astăzi, este de facto-sinonim pentru o clasă de limbaje de descriere ușoare de marcare, iar obiectivul poate fi văzut ca atins.
Markdown folosește o sintaxă de formatare a textului simplu. Cu o abordare similară cu cea HTML, un număr de markeri indică titluri, liste, imagini și referințe în text. Câteva rânduri de mai jos ilustrează un document de bază care conține două titluri (primul și al doilea nivel), precum și două paragrafe și un mediu de listă.
## Franța
Aceasta este o selecție de locuri:
* Paris (_Ile de France_)
* Strasbourg (_Alsace_)
Pentru un plan de vizită adecvat aproximativ o săptămână.
Conversia în DOCX
Pentru a vă converti documentul Markdown în DOCX, utilizați instrumentul pandoc [3]. Pandoc este o bibliotecă Haskell și se descrie ca „convertorul universal de documente” sau „cuțitul elvețian pentru conversia documentelor”. Este disponibil pentru o varietate de platforme precum Linux, Microsoft Windows, Mac OS X și BSD. Pandoc este de obicei inclus ca pachet pentru distribuții Linux, cum ar fi Debian GNU / Linux, Ubuntu și CentOS.
Un apel simplu pentru o conversie este după cum urmează:
$ pandoc -o test.test docx.mdPrimul parametru „-o” se referă la fișierul de ieșire, urmat de numele fișierului („test.docx '). Extensia de fișier ajută pandoc să identifice formatul de ieșire dorit. Al doilea parametru numește fișierul de intrare - în cazul nostru este pur și simplu „test”.md '.
Versiunea lungă a comenzii prezentate mai sus conține cei doi parametri „-f markdown” și „-t docx”. Primul abreviază termenul „aromă” și descrie formatul fișierului de intrare. Al doilea face același lucru pentru fișierul de ieșire și abreviază „-to”.
Comanda completă este următoarea:
$ pandoc -o test.docx -f markdown -t test docx.mdDeschiderea fișierului convertit utilizând Microsoft Word are ca rezultat următoarea ieșire:
Pentru diferitele elemente de text Pandoc folosește foi de stil. Acest lucru vă permite să reglați aceste elemente mai târziu în funcție de nevoile dvs. de-a lungul întregului document. Versiunile mai noi ale Pandoc oferă și invers - puteți converti un fișier DOCX în Markdown după cum urmează:
$ pandoc -o test.md test.docxApoi, fișierul generat are următorul conținut:
Locuri recomandate de vizitat în Europa=====================================
Franţa
------
Aceasta este o selecție de locuri:
- Paris (* Ile de France *)
- Strasbourg (* Alsacia *)
Pentru un plan de vizită adecvat aproximativ o săptămână.
Opțiuni utile din linia de comandă
Lista opțiunilor Pandoc este destul de lungă. Următoarele vă ajută să obțineți rezultate mai bune și vă ușurează viața:
* '-P' (versiunea lungă '-preserve-tabs'): păstrați filele în loc să le convertiți în spații. Acest lucru este util pentru blocurile de coduri cu linii indentate care fac parte din textul dvs.
* '-S' (versiunea lungă '-smart'): produce o ieșire tipografică corectă.
Această opțiune corectează ghilimelele, cratimele / liniuțele, precum și elipsele („…”). Spații suplimentare, care nu se rup, sunt adăugate după anumite abrevieri precum „Mr.”.
* '-track-changes = value': specifică ce trebuie să faceți cu inserții, ștergeri și comentarii care sunt produse cu ajutorul caracteristicii Microsoft Word „Track Changes”. Valoarea poate fi acceptată, respinsă sau toate pentru a include sau elimina modificările făcute în document. Rezultatul este un fișier plat.
Pentru mai multe opțiuni, consultați documentația și pagina manuală a Pandoc.
rezumat
Conversia dintre Markdown și DOCX nu mai este un mister. Se face în câțiva pași și funcționează foarte bine. Fericire hacking 🙂
Linkuri și referințe
* [1] Markdown
* [2] Frank Hofmann: Introducere în Markdown
* [3] Pandoc
Mulțumiri
Autorul dorește să îi mulțumească Annettei Kalbow pentru ajutor în timpul pregătirii articolului.
