Centre d’aide
Des guides clairs et pratiques pour rédiger, compiler et partager des projets LaTeX et Typst.
Écrire en Markdown
Modifiez des fichiers .md en source ou en texte mis en forme, prévisualisez-les en direct et convertissez-les en LaTeX ou en Typst.
Passer de Source à Visuel
Un fichier Markdown (.md ou .markdown) a deux vues du même texte : Source montre le Markdown tel que vous le tapez, et Visuel le montre mis en forme pendant que vous écrivez.
Étapes
- Ouvrez un fichier Markdown. Il s'ouvre en Source.
- Choisissez le bouton Source / Visuel au début de la barre sous l'onglet, ou lancez Markdown : passer à l’éditeur visuel depuis la palette de commandes. Choisissez-le à nouveau pour revenir.
- En Visuel, les titres, listes, tableaux, images et formules s'affichent comme ils se liront. Placez le curseur dans une formule pour modifier sa source, avec un Aperçu de la formule dessous.
- Sélectionnez une image pour obtenir Modifier l’image, où vous changez son Chemin ou URL et son Texte alternatif avant de choisir Appliquer, et Supprimer l’image. Survolez un lien pour obtenir Ouvrir le lien et Supprimer le lien.
- Sélectionnez du texte en Visuel pour Ajouter un commentaire, Ajouter à la conversation ou Édition rapide. Les modifications, commentaires et modifications suivies de vos collaborateurs apparaissent dans les deux vues.
- Les deux vues partagent le curseur : changer de vue garde votre position. La vue se choisit pour chaque onglet.
Mettre en forme avec la barre d'outils
Sur un onglet Markdown, la barre d'outils insère du Markdown, et ses boutons fonctionnent de la même façon en Source et en Visuel.
Étapes
- Après le bouton Source / Visuel viennent Annuler, Rétablir, Niveau de titre (1 à 6), Gras, Italique, Code en ligne, Insérer un lien, Insérer une note de bas de page, Insérer une liste, Insérer une figure, Insérer un tableau, Insérer des équations alignées, Insérer une équation centrée et Insérer une fraction. Ce qui ne tient pas passe dans Plus d’actions Markdown, à la fin.
- Choisissez un Niveau de titre sur un paragraphe ou un titre pour fixer son niveau ; ailleurs, il insère un nouveau titre.
- Insérer une liste propose Liste à puces ou Liste numérotée, et Insérer un tableau vous laisse choisir la taille.
- Le Markdown n'a ni soulignement, ni citation, ni renvoi : ces boutons ne s'affichent pas sur un onglet Markdown.
- Faites un clic droit sur la barre et choisissez Masquer la barre d’outils de texte pour masquer les boutons de mise en forme ; le bouton Source / Visuel reste. Barre d’outils de texte, dans les paramètres de l'éditeur, les fait revenir.
Prévisualiser un fichier Markdown
L'aperçu affiche le fichier au fil de la frappe, la vôtre comme celle de vos collaborateurs, sans compilation.
Étapes
- Choisissez Aperçu dans la barre d'onglets d'un onglet Markdown, ou appuyez sur Ctrl+K, puis V (⌘K, puis V sur Mac). L'aperçu s'ouvre à côté de la source.
- Il affiche les tableaux, les listes de tâches, les notes de bas de page, les formules écrites avec $ et $$, les diagrammes Mermaid, et les alertes comme > [!NOTE] sous forme d'encadrés. Un en-tête YAML est omis, et le HTML du fichier n'est pas affiché.
- Les images peuvent être des fichiers du projet, par leur chemin depuis le fichier Markdown, ou des adresses https. Un lien vers un autre fichier du projet ouvre ce fichier.
- L'aperçu suit la source quand vous la faites défiler. Double-cliquez sur un bloc, ou faites Ctrl-clic (Cmd-clic sur Mac), pour aller à sa ligne dans la source.
- Un clic droit dans l'aperçu propose Aller à la source et Ouvrir le fichier source.
Importer et exporter du Markdown
Le Markdown peut devenir du LaTeX ou du Typst, et un projet LaTeX ou Typst peut être exporté en Markdown.
Étapes
- Pour démarrer un projet depuis un brouillon Markdown, ouvrez la flèche à côté de Nouveau projet, choisissez Importer depuis des fichiers, sélectionnez le fichier .md, choisissez LaTeX ou Typst, puis Lancer l’importation.
- Dans un projet, faites un clic droit sur un fichier .md dans l'Explorateur et choisissez Convertir en LaTeX (Convertir en Typst dans un projet Typst) ; le résultat est écrit à côté.
- Pour obtenir une copie Markdown d'un projet, ouvrez le bouton ••• Actions du projet dans la barre de titre et choisissez Markdown (.md) sous Exporter. Les équations restent en TeX et les images vont dans un dossier à côté du texte.
- Les Notes personnelles sont aussi du Markdown : Télécharger sur une page sans images enregistre son fichier .md.
