217 votes

Comment puis-je convertir le format Markdown de Github en PDF ?

J'ai récemment commencé à apprendre le format Markdown pour la documentation et j'ai besoin d'imprimer quelques-unes de mes pages Markdown. J'aimerais utiliser un utilitaire en ligne de commande, Terminal, etc. qui me permette de convertir le format Markdown à la sauce Github en PDF. Il doit disposer d'une coloration syntaxique appropriée et ne doit pas avoir l'air horrible. Merci pour toute aide.

1 votes

Le coloriage syntaxique sur GitHub ne fait pas partie de GitHub Flavored Markdown. Du moins, pour autant que je sache.

0 votes

@OliverSalzburg Utilisations de Github Linguiste pour fournir une coloration syntaxique.

1 votes

@dillmo, Convert en HTML d'abord puis utilisez Chrome pour imprimer au format PDF.

205voto

Josh Werts Points 2156

J'ai eu du succès en utilisant poignée pour afficher le format markdown dans Chrome, puis utiliser l'option "Enregistrer en PDF" de Chrome dans la boîte de dialogue Imprimer.

pip install grip  
grip your_markdown.md

grip rendra le markdown sur localhost:5000 ou similaire (ex : allez sur http://localhost:5000/) - il suffit de modifier et de rafraîchir le navigateur. Imprimez quand vous êtes prêt.

Cela a donné une représentation plus fiable que pandoc et était plus léger que l'installation de latex (requis par pandoc pour la génération de pdf).

L'impression n'est pas en ligne de commande dans cette réponse, mais j'ai quand même trouvé cela plus facile/plus fiable (ressemble à 100% à Github pour un long document comprenant des images relativement liées et la mise en évidence du code).

3 votes

C'est assez facile.

33 votes

grip your_markdown.md --export your_markdown.html est une option utile ici. Il l'exporte dans un fichier html, qui peut ensuite être imprimé à partir de la ligne de commande en utilisant quelque chose comme wkhtmltopdf.

0 votes

Sous Ubuntu, je n'ai pas réussi à faire fonctionner les liens croisés dans le PDF sauvegardé lors de l'impression en PDF à partir de Firefox ou de Chromium et j'ai dû télécharger le fichier précompilé wkhtmltopdf plutôt que d'utiliser la version incluse dans les dépôts Ubuntu.

72voto

Quanlong Points 1110

Vous pouvez également utiliser le système Node.js. markdown-pdf

npm install -g markdown-pdf
markdown-pdf /path/to/markdown

2 votes

C'est assez génial et très facile. Le problème du lien provient de la css d'impression du modèle html5, que vous pouvez simplement commenter ou remplacer par votre propre feuille de style.

0 votes

J'aimerais ajouter qu'il est doté d'un support Unicode prêt à l'emploi, ce qui est très appréciable.

0 votes

Vous pouvez également installer github-markdown-css si vous souhaitez utiliser le fichier CSS de GitHub.

52voto

Brian Moeskau Points 101

Jetez un coup d'œil à pandoc . Il dispose d'une coloration syntaxique. Vous devrez peut-être apporter des modifications (mineures) à votre document, car il possède sa propre version de markdown et je ne sais pas dans quelle mesure elle correspond à celle de GitHub.

4 votes

Merci. En cours d'exécution pandoc -h a retourné la prise en charge de GitHub Flavored Markdown, je marque donc cette question comme résolue.

3 votes

J'ai essayé d'installer pandoc sur Fedora Linux et a rencontré un cauchemar de dépendance - principalement lié à LaTex. Je vous conseille d'éviter pandoc et d'essayer d'abord d'autres options.

0 votes

Pour ceux qui utilisent des lettres non-ASCII et qui les voient manquer : ajoutez des options de police à pandoc comme celles-ci : --variable mainfont="Liberation Serif" --variable sansfont="Liberation Sans"

12voto

Andrew Garrison Points 3329

Mise à jour 2021-11 : Le projet a été abandonné, le domaine héberge maintenant des publicités ou des logiciels malveillants.

Si le fichier markdown était hébergé sur un dépôt github, gitprint était une option intéressante pour créer des pdf / print.

Tout ce que vous aviez à faire était de remplacer github.com por gitprint.com dans l'URL.

Malheureusement, il ne fonctionne pas sur les gists markdown, et ne fonctionne qu'avec les fichiers markdown du dépôt.

5 votes

Il ne fonctionne pas non plus avec les images :(

0 votes

...et est mal formulé :(

0 votes

Option intéressante. Pour : les liens externes sont maintenus et accessibles depuis la sortie. Contre : la sortie est en noir et blanc, les liens d'ancrage sont supprimés, les liens externes ne sont pas indiqués visuellement car ils sont en noir et blanc.

11voto

kevgathuku Points 111

Il existe un convertisseur en ligne disponible à l'adresse suivante http://www.markdowntopdf.com
Cela fournit une coloration syntaxique dès le départ et c'est la solution la plus simple que j'ai vue jusqu'à présent. Elle gère aussi correctement d'autres fonctionnalités spécifiques à GFM, par exemple les tableaux.

8 votes

Ne gère pas les images dans des fichiers séparés.

0 votes

Fonctionne à merveille

SistemesEz.com

SystemesEZ est une communauté de sysadmins où vous pouvez résoudre vos problèmes et vos doutes. Vous pouvez consulter les questions des autres sysadmins, poser vos propres questions ou résoudre celles des autres.

Powered by:

X