À propos de la conversion de Markdown en PDF
Le Markdown est la façon la plus simple d'écrire un document et la plus pénible d'en envoyer un.
Vous avez écrit les notes, le README, la spécification, le rapport. C'est parfait dans votre éditeur. Puis quelqu'un le demande en PDF, et les options sont : installer une chaîne d'outils, coller le tout dans un traitement de texte et réparer la mise en forme à la main, ou le pousser dans un dépôt et faire une capture d'écran de la page.
Collez-le ici à la place. L'aperçu à droite est ce que sera le PDF, et le bouton en fait un.
Ce qui survit au voyage
Tout ce qu'on attend du Markdown façon GitHub :
- Les titres — tous les niveaux, avec les espacements qu'un document doit avoir
- Les listes — à puces, numérotées et imbriquées
- Les tableaux — avec bordures et une ligne d'en-tête teintée
- Le code — en ligne comme ceci, et en blocs qui gardent leur indentation
- Les citations, filets horizontaux, gras, *italique* et liens
- Les images, tant que ce sont des data-URI ou des URL accessibles
L'aperçu et le PDF sont dessinés à partir de la même feuille de style : ce que vous voyez est donc vraiment ce qui sera imprimé. Il n'y a pas de deuxième étape de mise en page pour vous surprendre.
Deux styles
- Document sobre — une police à empattements et un interligne généreux. Le bon choix pour un rapport, une proposition, un texte suivi, tout ce qu'on lit du début à la fin.
- Style README — une police sans empattements avec des titres soulignés, plus proche de l'allure d'un README sur une plateforme de code. Le bon choix pour de la documentation et des notes techniques.
Réglage de la page
A4 ou Letter, portrait ou paysage, et une marge que vous donnez en millimètres. Le paysage mérite d'être retenu pour tout ce qui comporte des tableaux larges ou de longues lignes de code — c'est la différence entre un tableau qui tient et un tableau qui déborde.
Les numéros de page sont activés par défaut et apparaissent centrés en pied de page. Désactivez-les pour un document d'une seule page, où ils n'ajoutent que du bruit.
Rien ne quitte votre appareil
Le Markdown est rendu et le PDF est écrit dans votre navigateur. Rien n'est envoyé, donc :
- Spécifications non publiées, notes internes et travail client restent où ils sont
- Il n'y a aucune limite de taille due à un envoi
- Cela fonctionne hors ligne une fois la page chargée
- Votre texte est conservé dans ce navigateur entre les visites, pour qu'un onglet fermé ne perde pas votre travail — et uniquement dans ce navigateur
Pourquoi les pages sont peintes, pas composées
Chaque page est dessinée comme une image puis placée dans le PDF, plutôt qu'écrite en texte PDF. C'est délibéré : les polices standard du PDF ne savent pas du tout encoder le hangul, les kana, les sinogrammes ou le cyrillique, et un document Markdown peut être dans n'importe quelle langue.
Dessiner la page utilise vos propres polices système : toutes les écritures s'affichent donc correctement. En contrepartie, le texte du PDF final n'est pas sélectionnable — le même compromis que fait Word en PDF, pour la même raison. S'il vous faut du texte sélectionnable et que votre document est en alphabet latin, Créateur de CV montre à quoi ressemble l'autre approche.
Ce que les gens convertissent
- Un README ou une page de documentation, pour quelqu'un qui n'utilise pas de plateforme de code
- Des notes de réunion écrites en Markdown, transmises comme document
- Une spécification ou une proposition rédigée dans un éditeur de texte
- Des fiches de révision à imprimer ou à lire sur une tablette
- Un journal des modifications à joindre à un e-mail
- Du support de cours écrit en Markdown et distribué en PDF
Bon à savoir
- Le HTML brut présent dans votre Markdown est nettoyé avant le rendu : un document collé ne peut donc rien exécuter
- Un document très long demande quelques secondes par page — tout le travail est local
- Les images venant d'Internet n'apparaissent que si le site autorise une autre page à les lire ; les images collées en data-URI fonctionnent toujours
- Pour l'autre sens, ou simplement pour écrire du Markdown, utilisez l'Éditeur Markdown
- Pour fusionner le résultat avec un autre PDF, utilisez Fusionner des PDF
Comment l'utiliser
- Collez votre Markdown à gauche, ou appuyez sur Ouvrir un .md pour charger un fichier
- Vérifiez l'aperçu à droite — c'est à cela que ressemblera le PDF
- Choisissez le format, l'orientation, la marge et le style
- Cochez Ajouter les numéros de page si vous en voulez
- Appuyez sur Créer le PDF, puis Télécharger le PDF
Outils liés
- Éditeur Markdown — écrire du Markdown avec une barre d'outils et un aperçu en direct
- Word en PDF — le même moteur PDF, en partant d'un .docx
- PDF en texte — récupérer du texte brut depuis un PDF
- Fusionner des PDF — joindre ce PDF à d'autres
- Numéroter les pages d'un PDF — numéroter un PDF existant
- Compresser un PDF — alléger le fichier avant de l'envoyer
