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

J'ai raffiné cet extrait pour mes besoins personnels :

# sudo apt install grip wkhtmltopdf

MD=${1:-README.md}
PDF=${2:-"$MD".pdf}
PORT=8971
DELAY=10

printf "Converting $MD to $PDF on port $PORT\n"
printf "Waiting $DELAY seconds for server to start...\n"

grip "$MD" localhost:$PORT &
sleep $DELAY
wkhtmltopdf http://localhost:$PORT "$PDF"
kill $(ps -eo pid,command | grep grip | grep -v grep | awk '{print $1}')

Enregistrer sous /usr/local/bin/md2pdf y sudo chmod +x /usr/local/bin/md2pdf après.

Utilisation :

• md2pdf convertit le fichier README.md en README.md.pdf

• md2pdf foo.md convertit foo.md en foo.md.pdf

• md2pdf foo.md bar.pdf convertit foo.md en bar.pdf

Ma solution : convertir markdown avec pandoc vers html (n'oubliez pas pour utiliser le css pour pandoc pour afficher les bordures des tableaux) puis l'ouvrir avec libreoffice choisissez une option export as pdf .

NB : aucune des solutions mentionnées ici et sur Internet n'a fonctionné pour moi : 1) solutions basées sur un navigateur (c'est-à-dire la poignée) ajoutent des informations superflues, comme les numéros de pages, que je n'ai pas réussi à supprimer, 2) la conversion de pandoc en pdf est cassée, pour moi elle génère un tableau vide (peut-être à cause de l'unicode, et oui, je l'ai configuré pour utiliser xetex) 3) solutions sur site (par exemple, gitprint.com) ajoutent également des choses redondantes, comme des marges de type github, alors que j'ai juste besoin d'un simple tableau que j'ai généré avec awk !

J'ai essayé plusieurs plugins chrome et convertisseurs en ligne.
MDtr2PDF est le meilleur. Il prend en charge Github-flavoured-markdown et unicode.

Je convertis simplement à partir de HTML à la place. Cela fonctionne pour mes besoins :

https://github.com/dompdf/dompdf

J'ai constaté qu'en général, Markdown n'est pas un bon format pour la conversion en PDF, car il n'a pas de support CSS natif. Voici le script que j'utilise :

<?php
require 'dompdf/autoload.inc.php';
use Dompdf\Dompdf;

$dompdf = new Dompdf();
$dompdf->getOptions()->setIsFontSubsettingEnabled(true);
$s_in = file_get_contents('index.html');
$dompdf->loadHtml($s_in);

$dompdf->render();
$s_out = $dompdf->output();
file_put_contents('index.pdf', $s_out);

Cette solution ne nécessite que PHP (25 Mo) et DomPdf (4 Mo), elle est donc assez légère. par rapport aux autres options.

MDPDF - Convertisseur de Markdown en PDF.

Un convertisseur markdown vers pdf en ligne de commande avec prise en charge des en-têtes de page, des pieds de page et des feuilles de style personnalisées. Mdpdf est incroyablement configurable et possède une API JavaScript pour une utilisation plus extravagante.

Installation

Installer globalement pour l'utiliser à partir de la ligne de commande :

npm install mdpdf -g

Utilisation

$ mdpdf --help

Usage:
   $ mdpdf <source> [<destination>] [options]

<source> must be a markdown file, with the extension '.md'.

Examples:
   $ mdpdf README.md
   $ mdpdf README.md --style=styles.css --header=header.hbs --h-height=22mm
   $ mdpdf README.md --footer=footer.hbs --f-height=22mm --debug
   $ mdpdf README.md --border-left=30mm

Options:
   --style=<filename>           A single css stylesheet you wish to apply to the PDF
   --header=<filename>          A HTML (.html) file to inject into the header of the PDF
   --h-height=<height>          The height of the header section
   --footer=<filename>          A HTML (.html) file to inject into the footer of the PDF
   --f-height=<height>          The height of the footer section
   --border=<size>              Border (top, left, bottom, right; default: 20mm)
   --border-top=<size>          Top border (default: 20mm)
   --border-left=<size>         Left border (default: 20mm)
   --border-bottom=<size>       Bottom border (default: 20mm)
   --border-right=<size>        Right border (default: 20mm)
   --gh-style                   Enable default gh-styles, when --style is used
   --no-emoji                   Disables emoji conversions
   --no-highlight               Disables syntax highlighting
   --debug                      Save the generated html for debugging
   --help                       Display this menu
   --version                    Display the application version
   --format=<format>            PDF size format: A3, A4, A5, Legal, Letter, Tabloid (Default: A4)
   --orientation=<orientation>  PDF orientation: portrait or landscape (Default: portrait)

  Length parameters (<height> and <size>) require a unit. Valid units are mm, cm, in and px.

Global Settings:
      You can also set a global default stylesheet by setting the MDPDF_STYLES environment variable as the path to your single css stylesheet. The --style flag will override this.