I den sidste artikel lærte vi, hvordan Markdown hurtigt kan hjælpe dig med at producere ren HTML-kode, der skal bruges på et websted eller en blog. Men hvad nu hvis du også vil producere en e-bog med det samme indhold, som du har på internettet? Mens Markdown-værktøjssættet er rettet mod at skabe webindhold, er der et andet værktøj, der giver dig mulighed for at tage Markdown og gøre det til OpenOffice / LibreOffice-dokumenter, PDF'er eller endda e-bøger, der passer til en Kindle eller anden e-læser - Pandoc.

Installering af pandoc-pakken på et Ubuntu-system er død enkelt med følgende kommando:

 sudo apt-get install pandoc 

Når du er installeret, kan du straks bruge Pandoc i stedet for Markdown til at oprette HTML med følgende kommando:

 pandoc -r markdown -w html -o * ditfilnavn * .html * ditfilnavn * .md 

Syntaxen og flagene er som følger:

  • "-r" - læs format
  • "-w" - skriveformat
  • "-o" - filnavn af output

Hvad ovenstående kommando gør er at læse fra en markdown-fil og uddata filen i HTML-format med det samme filnavn.

Ovennævnte eksempel output filen i HTML-format, men du kan også bruge Pandoc til at generere andre formater.

Open Document Text Format (ODT)

Hvis du skal udveksle dit dokument med personer, der bruger en mere generisk kontorsuite, f.eks. OpenOffice / LibreOffice eller Microsoft Office, kan du konvertere det til ODT-format ved hjælp af Pandoc. Hvis du tror, ​​at du vil gøre dette ofte, er det nyttigt at oprette en skabelon på forhånd. For det første skal du oprette et simpelt dokument (som en overskrift og en linje eller to af teksten) i Markdown og konvertere den til ODT med følgende kommando:

 pandoc -r markdown -w odt -o pandoctemplate.odt * ditfilnavn * .md 

Derefter åbner du filen "pandoctemplate.odt" i Open / LibreOffice for at ændre skrifttyper, mellemrum, margener osv. Til din smag. Sørg for at bruge Styles til at konfigurere dette - nogle detaljer om brugen af ​​stilarter er tilgængelige her. Når dit dokument er indstillet til din smag, kan du bruge det som en skabelon til at oprette ODT-filer fra Markdown i fremtiden ved at tilføje den til ovenstående kommando:

 pandoc -r markdown -w odt --reference-odt = pandoctemplate.odt -o * ditfilnavn * .odt * ditfilnavn * .md 

Nu, når du konverterer en Markdown-fil til ODT, bliver den automatisk formateret med de stilarter, du tidligere har oprettet. Pandoc understøtter også konvertering til det nye (version 2007 og senere) Microsoft Word-format med flag " --reference-docx=templatefile.docx ".

Portable Document Format (PDF)

Når jeg skal generere PDF-filer fra Markdown, konverterer jeg oftest det ODT, og bruger enten LibreOffice's Export to PDF-funktion, eller hvis det er en stor gruppe filer, kommandolinjeprogrammet "unoconv". Hvis du er en LaTeX-bruger, og har et antal pakker installeret (dette afsnit i Pandoc-dokumentationen beskriver, hvad der kræves), kan du output PDF-filer med følgende kommando:

 pandoc -r markdown -o * yourfilename * .pdf * yourfilename * .md 

Bemærk fraværet af "-w" flag i dette tilfælde.

ePub e-bøger

For at udgive e-bøger, der passer til de fleste elektroniske læsere (ePub er et format, der håndteres af næsten alle læsere), kan du have nogle specifikke elementer til det format, der er udarbejdet på forhånd. Disse omfatter:

  • Et stylesheet, skrevet i CSS, der beskriver, hvordan ePub'en ser ud
  • Metadata, såsom skaberen, beskrivelsen, rettighederne til arbejdet og sproget
  • Et coverbillede

Hvis du ikke har disse, vil Pandoc imidlertid bruge nogle rimelige standardindstillinger. Følgende kommando konverterer dit Markdown-dokument til en ePub:

 pandoc -r markdown -w epub -epub-metadata = * metadatafile * .xml --epub-cover-image = * coverimage * .jpg --epub-stylesheet = * stylesheet * .css -o * ditfilnavn * .epub * yourfilename * .md 

Yderligere Markdown Tips

Her er nogle ekstra tips og tricks, jeg bruger i forbindelse med at bruge Markdown til mine skriveopgaver:

  • Da det er ren tekst, hvis du bruger DropBox til at holde filer i synkronisering mellem enheder, kan du bruge den indbyggede teksteditor til at oprette eller opdatere dine Markdown-dokumenter på internettet. Der er også redaktører til rådighed for Linux (jeg synes at kunne lide ReText meget) og Android (jeg har skiftet mellem Writer, Epistle og kodeditoren DroidEdit på det seneste).
  • Også, da det er almindelig tekst, gør samtidige versionssystemer (f.eks. Subversion) et fremragende arbejde med sporing af versioner og viser forskellene mellem dem.
  • Når du har konverteret et par dokumenter og ved, hvilke flag du har brug for for alle de ønskede formater, kan du oprette et simpelt shell-script, der vil sende dem alle på én gang.

Jeg har fundet Markdown at være en glimrende måde at udarbejde indhold på i et "distraheringsfrit" miljø (de fleste almindelige tekstredaktører er), der understøtter output til flere formater, men kræver ikke nogen dedikerede applikationer.

Billedkredit: Typewriter closeup shot, koncept af Kapitel 1 af Big Stock Photo.