# Markdown vers Typst

Convertissez des notes Markdown en code source Typst et ouvrez-les dans un projet d'écriture local et rapide.

Markdown vers Typst conserve le démarrage facile du Markdown et offre au brouillon un système de composition plus expressif quand il est prêt. La structure et les mathématiques courantes passent à travers, tandis que le résultat reste du code source brut que vous pouvez remanier.

## À quoi il sert

- des notes qui sont devenues un rapport, un polycopié ou un article ;
- un brouillon Markdown qui a besoin d'une mise en page plus poussée ;
- essayer Typst sans retaper le contenu.

Ne convertissez pas juste pour la nouveauté. Si un dépôt, un site statique ou un collaborateur attend du Markdown, sa portabilité peut avoir plus de valeur que le contrôle supplémentaire de la mise en page.

## Convertir la source

1. Ouvrez **Markdown vers Typst**, ou exécutez `/markdown-to-typst`.
2. Collez le Markdown.
3. Choisissez **Convertir**.
4. Inspectez le Typst généré.
5. Copiez-le, enregistrez `converted.typ`, ou créez un projet Typst.

Par exemple, les titres Markdown, le texte en gras, une liste numérotée et les mathématiques délimitées par des dollars deviennent leurs équivalents Typst. La conversion s'exécute localement avec le Pandoc embarqué.

## Ce qu'il faut ajuster ensuite

Le Markdown compte de nombreux dialectes. Les listes de tâches, le HTML brut, les directives personnalisées, les extensions de citation et la syntaxe d'extension peuvent ne pas passer le cap. Typst demande aussi ses propres choix pour les modèles, le style de bibliographie, la géométrie des pages et les fonctions réutilisables.

Compilez le nouveau projet et vérifiez :

- la hiérarchie des titres et l'imbrication des listes ;
- les équations et les blocs de code ;
- les liens et les chemins des images ;
- les notes de bas de page et les citations ;
- toute extension Markdown qui ne fait pas partie du format de base.

Pour une soumission LaTeX, utilisez directement [Markdown vers LaTeX](/docs/tools/markdown-to-latex/). Pour le chemin inverse, utilisez [Typst vers Markdown](/docs/tools/typst-to-markdown/). Pour un espace de travail Typst vierge, commencez par l'[Éditeur Typst visuel](/docs/tools/visual-typst-editor/) ou l'[Éditeur Typst](/docs/tools/typst-editor/).