Pandoc és un programa que permet passar d'un llenguatge de marques a un altre amb una dificultat mínima. Una de les principals característiques és que, a partir d'un document de text pla amb les quatre marques del llenguatge markdown (que el propi pandoc expandeix) podem arribar a obtenir el document en diferents formats: HTML, S5 HTML (presentacions), LaTeX, ConTeXt, PDF, RTF, DocBook XML, OpenDocument XML, ODT, i el codi editable de MediaWiki, per citar els més populars.
L'edició del document font en text pla es pot fer amb qualsevol editor de text pla, com ara gEdit per Linux o Notepad++ per uindous. Amb gEdit comptem amb l'ajut d'un ressaltador de sintaxi que es pot descarregar i instal·lar al programa amb la qual cosa se'ns facilita l'edició:
La senzilla sintaxi de markdown la trobarem a la pàgina syntax de la web del projecte i la sintaxi ampliada que pot utilitzar pandoc a la seva web.
Pandoc afegeix les següents millores a markdown:
- metadades al document (títol, autor, data).
- notes al peu, taules i llistes de definició.
- superíndexs, subíndexs i tatxadures.
- codificació matemàtica de LaTeX i comandaments de LaTeX que permeten millorar taules, per posar un exemple.
- Markdown dins de blocs d'HTML.
- millores a les llistes ordenades: el número d'inici i l'estil de numeració són importants.
- i d'altres
Què pot fer pandoc? Una llarga llista de canvis de format de documents que podeu trobar en la web del projecte. Però pels casos més comuns, i depenent del tipus de sortida en què vulguem el producte, hauríem de preparar abans algun fitxer que millorarà enormement el resultat que obtindrem.
- si volem un PDF no està de més preparar un fitxer preambul.tex on escriure els paquets i opcions que vulguem perquè pandoc l'utilitzarà quan convertim el fitxer markdown a PDF amb el comandament markdown2pdf. Feu clic aquí per veure el resultat PDF obtingut a partir del fitxer markdown mostra.txt.
- si volem un HTML caldrà preparar un senzill fitxer que faci de peu de pàgina i, sobretot, un full d'estils que personalitzi i millori el codi resultant. Feu clic aquí per veure el resultat HTML obtingut a partir del mateix fitxer mostra.txt amb l'ajut del full d'estils pandoc.css.
Ai! Se m'oblidava afegir que no cal descarregar-se res per provar (o utilitzar) pandoc. Podeu anar a la pàgina Try pandoc i jugar una mica amb les possibilitats de transformació i generació de formats.