2013-02-15 11 views
10

Ho scritto un carico di documentazione tecnica in Markdown. Ho scelto di usarlo per il controllo delle versioni e quindi possiamo visualizzare su GitHub.Conversione di più file Markdown con collegamenti a PDF

Ora dobbiamo condividere questo con utenti esterni (che non sono così comodi con Markdown), quindi mi piacerebbe convertirlo in PDF.

Gimli sembra essere lo strumento migliore che ho trovato per la conversione (usa lo stesso foglio di stile di GitHub così sembra lo stesso), tuttavia non converte anche i collegamenti. C'è qualcosa che farà anche questo?

risposta

11

non so con quale tipo di link che hai problemi (link in linea, link di riferimento, i link HTML, link immagine, collegamenti automatici ...), ma si può provare a usare Pandoc:

pandoc *.md -o result.pdf 

Questo convertirà tutti i file con l'estensione del file *.md in un unico pdf.

+2

Non funziona per i collegamenti interni, ma sembra essere lo strumento migliore finora. Grazie. –

+0

In che modo pandoc risolve l'ordinamento delle pagine? Supponiamo di avere 10 file * .md, come posso specificare l'ordine in cui sono visualizzati? – CadentOrange

+0

In bash è un elenco in ordine alfabetico. Vedi f.ex. [È possibile modificare l'ordine di un glob?] (http://unix.stackexchange.com/questions/34063/is-it-possibile-per-cambiare-il-ordine-di-un-globale) risposte per altre possibilità. – Sonson123

-3

NO !!! Davvero non devi farlo !!! Semplicemente "cat * .md> allpages.md" (potresti voler organizzare manualmente l'ordine o configurare ciascun file con un nome appropriato per far funzionare il gatto), quindi apri l'allpages.md e poi seleziona print/export in qualsiasi editor markdown! !!!

Non è necessario installare NULLA !!!!

Problemi correlati