Guide Markdown

Markdown au quotidien

# Titre du document

## Section

**Gras**, *italique* et ~~supprimés~~.

- Premier élément
- Deuxième élément

1. Première étape
2. Deuxième étape

- [x] Terminé
- [ ] Tâche suivante

| Fonctionnalité | État |
| --- | --- |
| Aperçu en direct | Prêt |
| Récupération locale | Prêt |

[Exemple](https://example.com)

![Texte alternatif](https://example.com/image.png)

Utilisez `inline code`.

```js
const message = "Hello";
```

La zone est $A = \pi r^2$.

$$
E = mc^2
$$

```mermaid
flowchart LR
  A[Écrire] --> B[Aperçu]
  B --> C[Enregistrer un fichier]
```

Ouvrir et enregistrer des documents

Utilisez le menu Fichier → Ouvrir des fichiers, ou glissez-déposez des fichiers .md, .markdown ou .txt dans l'espace de travail. Chaque fichier s'ouvre dans un nouvel onglet ; le document courant n'est pas remplacé. Les nouveaux documents sont initialement vides. Les fichiers UTF-8 jusqu'à 2 Mio sont pris en charge, avec un maximum de 20 onglets.

L'option « Enregistrer » enregistre le fichier dans un fichier local sélectionné si le navigateur le permet et si l'autorisation est accordée. Sinon, un téléchargement Markdown est lancé. Une demande de téléchargement ne confirme pas l'enregistrement du fichier sur le disque. L'option « Enregistrer sous » permet de choisir un nouvel emplacement. Après un rechargement, un fichier précédemment ouvert doit être rouvert pour rétablir l'enregistrement direct.

La récupération du navigateur n'est pas une sauvegarde de fichiers

La récupération permet de sauvegarder les documents ouverts et l'état des onglets dans ce navigateur. Toutes les langues de l’interface partagent le même espace de travail. Le point d'un onglet indique les modifications apportées depuis le dernier enregistrement de fichier ou la dernière demande de téléchargement Markdown, et non l'état de récupération du navigateur.

La navigation privée, la suppression des données de stockage et l'effacement des données du site peuvent supprimer les copies de récupération. Enregistrez vos documents importants dans des fichiers. La fermeture d'un onglet modifié requiert une confirmation ; la fermeture de tous les documents supprime leurs copies de récupération après confirmation. Les modifications non enregistrées dans un autre onglet du navigateur ne sont pas fusionnées automatiquement.

Un espace de travail confortable

Utilisez les commandes de la deuxième rangée pour basculer entre l'affichage fractionné, le mode source uniquement et l'aperçu uniquement. En mode fractionné, l'aperçu ne suit que le défilement volontaire de l'éditeur. Le défilement de l'aperçu ou la saisie dans le code source ne déplace pas l'autre volet. La position de lecture est conservée grâce à la correspondance des blocs Markdown lors des modifications de contenu ; les réécritures importantes et les sections supprimées utilisent un bloc Markdown adjacent. Désactivez le suivi pour des volets totalement indépendants.

Le bouton « Plan » ouvre les titres du document sans barre latérale permanente. Le menu des paramètres propose les thèmes Système, Clair et Sombre, un curseur de taille de texte de 14 à 24 px, le choix entre une police à chasse fixe ou sans empattement, la numérotation des lignes et des options de rendu. Les tailles de texte existantes sont conservées ; les nouveaux espaces de travail sont configurés par défaut à 16 px. Le bouton « Exemples » propose des extraits de code consultables avec les fonctions Copier et Insérer. Le bouton « Tableau » ouvre un sélecteur de colonnes et de lignes ; le nombre de lignes sélectionnées inclut l’en-tête. Ctrl/Commande + F permet d’effectuer une recherche dans le code source. Utilisez la touche Tabulation pour quitter l’éditeur et les flèches directionnelles pour naviguer entre les options de mise en forme.

Pour les documents contenant plus de 250 000 caractères UTF-16 ou plus de 10 000 sauts de ligne, la prévisualisation automatique est désactivée afin de préserver la réactivité du clavier. Utilisez l’option « Actualiser la prévisualisation » pour une mise à jour manuelle. L’édition et l’enregistrement Markdown restent possibles.

Équations

Les équations en ligne utilisent $...$ ou \(...\). Les équations en bloc utilisent $$ sur des lignes séparées, ou \[ et \] sur des lignes séparées. Le code entre accents graves n’est jamais traité comme une équation. Échappez un symbole monétaire avec \$ s’il risque d’être confondu avec une équation.

Le moteur de rendu KaTeX local prend en charge un sous-ensemble de LaTeX, et non les documents .tex complets. La sortie utilise MathML natif. Le rendu est limité à 100 expressions et à 4 000 caractères par expression. Les commandes non prises en charge ou non sécurisées conservent leur code source au lieu d'exécuter des scripts ou de charger des ressources externes.

Diagrammes Mermaid

Un bloc de code délimité et étiqueté mermaid est rendu localement lorsque le rendu des diagrammes est activé. Aucun diagramme n’est envoyé à un service en nuage. Le moteur de rendu s’exécute dans un environnement isolé à origine opaque, sans accès au réseau ni au stockage.

Jusqu'à 24 diagrammes de 12 000 caractères chacun peuvent être rendus. Une limite de 200 arêtes et des délais de rendu offrent une protection supplémentaire. Les directives de configuration et les métadonnées YAML incluses dans un diagramme sont rejetées. Les diagrammes invalides ou non pris en charge restent consultables en tant que source.

Transférez votre texte vers une autre application

Copier Markdown copie le code source. Copier HTML copie le balisage HTML portable, en conservant les équations et les diagrammes comme source. Copier le texte formaté fournit du HTML et du texte brut, idéal pour coller des titres, des mises en évidence, des listes et des tableaux dans des applications compatibles avec le contenu enrichi du presse-papiers. La mise en forme exacte dépend de l'application de destination ; les diagrammes et les équations restent dans le code source pour assurer la compatibilité avec le presse-papiers.

L'exportation HTML génère un document autonome contenant des équations MathML locales et des images de diagrammes nettoyées, une fois le rendu réussi. Elle ne nécessite pas de scripts IT Drawer. L'impression/l'enregistrement au format PDF utilise la boîte de dialogue d'impression du navigateur ; l'enregistrement au format PDF dépend du système d'exploitation. Les images Markdown externes restent bloquées, sauf si vous les autorisez explicitement pour ce document.

Utilisation et installation hors ligne

Choisissez Fichier → Hors ligne et installer, puis Activer le mode hors ligne tout en étant connecté. Cela prépare l'interface de l'éditeur pour toutes les langues et les bibliothèques de rendu. Les fichiers hors ligne sont indépendants de la récupération de documents. L'installation via le navigateur ou l'ajout à l'écran d'accueil est facultative.

Attendez que le menu indique que l'utilisation hors ligne est prête avant de vous déconnecter. L'espace de travail Markdown est compatible hors ligne, mais les images distantes, ce guide et les autres outils IT Drawer ne sont pas inclus. Le stockage du navigateur n'est pas permanent. Les mises à jour sont mises à jour après la fermeture des fenêtres de l'éditeur ; elles ne rechargent pas le document actif.

La suppression du cache hors ligne désenregistre uniquement les processus Markdown et supprime uniquement leurs caches d'application. Les documents de récupération sont conservés. Fermez toutes les fenêtres de l'éditeur après la suppression. Pour effacer également les documents, fermez-les dans l'éditeur ou effacez les données de navigation du site.