Du Markdown à un PDF prêt à partager

1. Commencez par votre Markdown

Collez votre texte dans l’éditeur ou ouvrez un fichier .md, .markdown ou .txt. Choisissez un titre descriptif, puis organisez le contenu en sections. L’aperçu suit vos modifications pendant la saisie : aucune étape distincte d’enregistrement ou d’actualisation n’est nécessaire. Sur un petit écran, passez de la rédaction à la relecture avec les onglets de l’éditeur et de l’aperçu.

Conservez une copie du Markdown original. Si vous essayez un modèle, vérifiez son contenu avant l’export afin de ne pas conserver de texte d’exemple dans le document final.

2. Structurez les titres et les accents

Écrivez le titre principal avec un seul # suivi d’une espace. Utilisez ## pour les grandes sections et ### pour les sous-sections. Deux astérisques de chaque côté d’un mot le mettent en gras ; un seul le met en italique, trois combinent les deux. Gardez des marqueurs correspondants. Leur ajout répété rend le texte source moins lisible et peut modifier son interprétation.

# Note de projet

## L’objectif

Clarifiez le **point essentiel**.
Utilisez *l’italique* ou ***les deux styles***.

- Première action
- Deuxième action

Laissez une ligne vide entre les paragraphes et autour des listes. Un retour à la ligne dans le texte source ne crée pas toujours un nouveau paragraphe dans le PDF. Des titres cohérents facilitent aussi la lecture du sommaire automatique.

3. Rendez les tableaux et le code lisibles

Les tableaux conviennent aux comparaisons courtes. Ajoutez une ligne de séparation sous les noms des colonnes et limitez le contenu des cellules. Un tableau confortable sur un écran peut paraître serré sur papier. Divisez une grande comparaison en petits tableaux ou placez les explications longues dans un paragraphe en dessous.

| Tâche | État |
| --- | --- |
| Rédaction | Terminée |
| Relecture | En cours |

```javascript
const total = 3 * 4;
console.log(total);
```

Utilisez des blocs délimités pour les exemples de code sur plusieurs lignes, et des accents graves pour une courte commande dans une phrase. Raccourcissez les lignes de code très longues : la page imprimée ne peut pas s’élargir comme votre éditeur.

4. Ajoutez les images utiles au document

Une image s’écrit avec un point d’exclamation, une description entre crochets et sa source entre parenthèses. Remplacez l’adresse ci-dessous par celle de votre image. L’outil Images permet aussi de choisir un fichier PNG, JPEG, GIF ou WebP local et de l’intégrer au Markdown. Rédigez un texte alternatif utile plutôt que de laisser un nom de fichier peu explicite.

![Calendrier du projet avec trois étapes](https://example.com/calendrier.png)

Vérifiez la présence de chaque image avant le téléchargement. Une image distante peut nécessiter une autorisation ou devenir indisponible ; un chemin local de votre ordinateur n’est pas automatiquement accessible au serveur d’export. Préférez des images adaptées au document à des originaux très volumineux.

Diagrammes, maths et sauts de page

Un bloc de code avec le langage mermaid devient un diagramme. Le TeX entre simples symboles dollar est une formule en ligne, entre doubles symboles dollar sur leurs propres lignes une formule centrée. Une ligne contenant seulement \newpage force une nouvelle page. Un bloc de front matter tout en haut définit le titre, le sous-titre, l'auteur, la date et les mots-clés utilisés par la couverture et les propriétés du PDF.

---
title: Spécification du service de paiement
author: Sam
---

```mermaid
flowchart LR
  A[Commande] --> B[Débit] --> C[Reçu]
```

L'attente après la tentative $n$ vaut $w_n = 2^n \cdot 250$ ms.

\newpage

Les diagrammes sont dessinés dans votre navigateur et envoyés avec la demande de PDF, rien n'est donc conservé sur le serveur.

5. Réglez la page avant la dernière relecture

Choisissez A4, A5 ou Letter, puis le style Épuré, Éditorial ou Technique. Ces réglages modifient le document exporté. Les marges confortables, compactes et spacieuses servent de point de départ ; les marges personnalisées permettent de régler chaque bord en millimètres. Prévoyez de la place pour les en-têtes et pieds de page lorsque vous les utilisez.

Activez un sommaire pour les documents longs : il reprend les trois premiers niveaux de titres. Vérifiez la numérotation et les éléments de marque, comme le texte ou le logo. Passer le site du mode clair au mode sombre est une préférence de lecture ; cela ne demande pas une impression sur fond sombre.

6. Exportez, vérifiez et téléchargez

Générez le PDF lorsque l’aperçu vous convient. L’aperçu accompagne la rédaction ; le PDF généré permet de vérifier les sauts de page, la position des images et les éléments répétés. Ouvrez-le et examinez la première page, une page contenant un tableau et la dernière page avant de le partager.

Le texte courant reste sélectionnable dans le PDF. MDPress construit le nom du fichier à partir du premier titre principal, ou à défaut d’un autre titre ou de la première ligne non vide. Par exemple, « Note de projet » devient « note-de-projet.pdf ». Choisissez un titre compréhensible même hors de votre dossier de téléchargements.

Les problèmes de mise en forme à vérifier

Si la présentation semble incorrecte, recherchez un bloc de code non fermé, des marqueurs d’emphase incomplets ou une ligne vide manquante. Si le contenu est serré, raccourcissez les cellules ou ajustez le format et les marges. Le HTML brut est traité comme du texte et le bloc YAML initial est retiré : utilisez les réglages du document pour configurer les options d’impression disponibles.

Où vont votre brouillon et votre export

Le texte du brouillon, les réglages et les préréglages enregistrés utilisent le stockage local de ce navigateur. Ce n’est pas une sauvegarde dans le cloud ; ils peuvent disparaître si vous effacez les données du navigateur. L’export transmet votre Markdown et ses réglages au serveur MDPress pour générer le PDF. Téléchargez une copie Markdown pour conserver une source réutilisable, notamment avant de changer d’appareil.