Ce site (sur Gitlab ou sur Github) vous propose un outil pour créer automatiquement à partir d’un fichier en markdown une page HTML à imprimer en A4, avec :
Pour configurer l’impression, il faut ajouter un en-tête au début de votre document markdown. Plusieurs paramètres sont disponibles.
Voici un exemple avec tous ces paramètres (on n'est pas obligé de tous les utiliser) :
---
pages: 1
colonnes: 2
espacementColonnes: 20px
mx: 20px
my: 20px
paysage: true
copies: 2
maths: true
---
pages
et colonnes
indiquent respectivement le nombre de pages et de colonnesespacementColonnes: 30px
mx
et my
définissent les marges à gauche et à droite (pour mx
), en haut et en bas (pour my
)paysage: true
copies: 2
pour deux copies.maths: true
permet d’écrire des formules mathématiques avec la syntaxe $FORMULE$
ou $$FORMULE$$
. Si la formule est trop longue, la mise en page risque cependant d’être perturbée et il faudra la retoucher manuellement.Copiez-coller votre markdown dans cet outil de conversion en ligne et cliquez sur le bouton “Convertir”:
https://eyssette.forge.aeif.fr/a4/convert.html
Clonez ce dossier (sur Gitlab ou sur Github) et créez des fichiers markdown dans votre dossier cloné. Ils seront automatiquement convertis et accessibles en ligne.
Sur Github, il faudra donner la permission : Read and Write
dans : Settings/Actions/General/Workflow permissions
Récupérez ce dossier (sur Gitlab ou sur Github) en local et ouvrez-le avec VSCode. Une tâche pour VSCode est définie dans le dossier .vscode afin d’automatiser la conversion du fichier markdown sur lequel vous travaillez.
Vous pouvez aussi utiliser le template pandoc, le filtre fr-nbsp.lua et le fichier CSS utilisé par défaut.
Hormis la syntaxe ordinaire, on peut aussi utiliser des codes emojis (p.ex. :smile:
), le surlignement (==texte surligné==
) et les blocs admonitions :
::: warning
Attention, bloc spécial de texte
:::
On peut aussi utiliser des balises HTML et notamment la balise
<style></style>
à l’intérieur de son document afin de modifier la feuille de style CSS.
On peut insérer des images avec la syntaxe Markdown habituelle :
![](URL)
mais le redimensionnement des images ne se fera pas automatiquement. On peut cependant utiliser la balise
<style>
afin de faire des modifications en CSS pour imposer une taille maximum de l’image (par exemple :
<style>img {max-height:100px}</style>
).
Cet outil est distribué gratuitement et sous licence libre.
Il dépend des outils libres suivants : pandoc et fr-nbsp pour les versions sur forge ou en local, et Markdown-it, Markdown-it-Emoji, Markdown-it-Admonition et js-yaml pour la version en ligne.