Éditeur de documents
MarginaliaMD intègre un éditeur WYSIWYG basé sur Milkdown (ProseMirror) qui permet de modifier vos documents Markdown directement depuis l'interface d'administration, sans avoir à éditer les fichiers sur le serveur.
Accès
Depuis le tableau de bord d'administration, cliquez sur l'icône de modification d'un document. L'éditeur s'ouvre à l'adresse /admin/edit.php?id=X.
Un sélecteur en haut de page permet de passer d'un document à un autre sans revenir au tableau de bord.
Barre d'outils
L'éditeur propose une barre d'outils avec les actions de mise en forme suivantes :
| Action | Description |
|---|---|
| Gras | Met le texte sélectionné en gras |
| Italique | Met le texte sélectionné en italique |
| Barré | Barre le texte sélectionné |
| Titres | Titres de niveau 1 à 6 |
| Liste à puces | Crée une liste non ordonnée |
| Liste numérotée | Crée une liste ordonnée |
| Liste de tâches | Crée une liste de cases à cocher |
| Bloc de code | Insère un bloc de code |
| Citation | Insère un bloc de citation |
| Tableau | Insère un tableau |
| Lien | Insère un lien hypertexte |
Raccourcis clavier
| Raccourci | Action |
|---|---|
| Ctrl+S | Sauvegarder le document |
| F11 | Basculer en mode plein écran |
Sauvegarde
Cliquez sur le bouton Enregistrer ou appuyez sur Ctrl+S pour sauvegarder. Un indicateur de statut en haut de page confirme l'enregistrement :
- Enregistrement... -- Sauvegarde en cours
- Enregistré -- Le contenu est identique à la version précédente
- Enregistré (nouvelle version) -- Le contenu a changé, une nouvelle version a été créée automatiquement
Modifications non sauvegardées : Si vous tentez de quitter la page avec des modifications non sauvegardées, un avertissement vous demande de confirmer.
Versionnage automatique
Chaque sauvegarde compare le contenu avec la version précédente via un hash SHA256. Si le contenu a changé, une nouvelle version est créée automatiquement. Les versions précédentes restent accessibles depuis la page des versions dans l'administration.
Actions sur le document
En haut de l'éditeur, des boutons permettent de :
| Action | Description |
|---|---|
| Télécharger | Télécharge le fichier Markdown brut |
| Voir | Ouvre le document dans la vue publique (nouvel onglet) |
| Supprimer | Supprime le document (avec confirmation) |
Syntaxe supportée
L'éditeur supporte le Markdown CommonMark et GFM (GitHub Flavored Markdown) :
- Texte en gras, italique, barré
- Titres de niveau 1 à 6
- Listes à puces, numérotées et de tâches
- Tableaux
- Blocs de code
- Citations
- Liens
- Images (via l'URL)
Le rendu dans l'éditeur est fidèle au rendu final dans la vue publique.