Guide pratique
Éditer du Markdown visuellement sur Mac
Rédigez une note de projet avec des titres, une liste de tâches et des liens dans Balise, puis retrouvez le même document en Markdown.
Un README, un plan ou une note de réunion doit rester facile à relire et à modifier. Dans Balise, le mode visuel permet de travailler sur le document mis en forme, tandis que le mode source donne accès à sa syntaxe Markdown. Les deux modes éditent le même fichier sur votre Mac.
1. Partir d’une note courte
Ouvrez un fichier .md ou créez un document Markdown dans Balise. Pour cet exemple, préparez une note de lancement avec un titre, une phrase d’objectif et deux tâches. Voici sa forme en source :
# Lancement du projet
Préparer une première version à faire essayer.
## À vérifier
- [ ] Relire la page d’accueil
- [ ] Tester le téléchargement
## Référence
[Plan du projet](plan.md)
Le lien vers plan.md suppose que ce fichier existe dans le même dossier. Vous pouvez le remplacer par le nom d’une de vos notes.
2. Écrire dans le mode Visuel
Passez en Visuel pour retrouver le titre, les tâches et le lien mis en forme. Modifiez la phrase d’objectif directement dans le document. Utilisez les commandes de mise en forme pour ajouter un titre, une liste ou du texte en gras.
Le rendu suit votre travail : ce mode permet l’édition, pas seulement la lecture. Vous pouvez aussi insérer un tableau ou une image lorsque votre explication en a besoin.
3. Consulter la source au bon moment
Passez en Source pour voir les marqueurs Markdown et vérifier la destination d’un lien. Revenez ensuite en Visuel pour poursuivre la rédaction. Il n’est pas nécessaire d’exporter le document pour passer d’un mode à l’autre.
Pour un document comportant des extensions Markdown complexes, privilégiez Source et contrôlez le résultat avant de sauvegarder. Une modification visuelle ne garantit pas la conservation de toutes les syntaxes étendues.
4. Enregistrer et réutiliser la note
Enregistrez le document avec ⌘S. Le résultat reste un fichier Markdown que vous pouvez rouvrir dans Balise ou utiliser avec les autres outils de votre projet. Les fichiers et images liés doivent rester accessibles depuis leur emplacement.
Quand plusieurs notes décrivent des étapes de travail, vous pouvez les organiser dans un tableau Kanban. Pour approfondir les commandes, consultez le chapitre Markdown du manuel, disponible en français.