MK4 - Markdown to Typst
MK4 est une extension VS Code conçue pour allier la simplicité de frappe du Markdown avec la puissance de rendu mathématique et typographique de Typst. Pensée pour la documentation technique, les rapports d'ingénierie et la prise de notes structurée.
Fonctionnalités Principales
- Aperçu en Direct (Live Preview) : Visualisez votre document rendu par Typst en temps réel (via SVG) directement dans un panneau VS Code.
- Annotations Typst (
:) : Étendez la syntaxe Markdown standard pour contrôler finement le rendu (alignement, taille, légendes, identifiants) sans polluer votre texte avec du code Typst.
- Autocomplétion Intelligente : Tapez
: en dessous d'un élément (titre, image, code) pour afficher les annotations compatibles.
- Mathématiques & Tableaux : Support complet des formules LaTeX (
$x^2$) et des tableaux GitHub Flavored Markdown, traduits nativement pour Typst.
- Thèmes Personnalisés : Injectez vos propres templates Typst pour un design sur mesure.
- Exports Multiples : Générez le rapport final en PDF, ou exportez le code source
.typ généré.
Ajoutez des attributs à vos éléments Markdown en utilisant le préfixe : juste en dessous (ou au-dessus pour le document) de ceux-ci.
Les Clés Universelles comme :id mon_identifiant et :align center|left|right peuvent être appliquées à presque tous les blocs.
Aucune annotations n'est obligatoire pour le fonctionnement du rendu.
Annotations disponibles
À placer tout en haut de votre fichier document.md :
:theme ./template.typ
:title Spécifications de l'Architecture
:subtitle Système embarqué temps réel
:author Robin Forestier
:date Juillet 2026
:lang fr
:numbering 1.1
:toc true
Titres
Contrôlez l'affichage de vos titres dans le document et la table des matières (TOC) :
# Architecture du système de détection
:short Architecture
:numbering false
:id sec_architecture
:width 50%
:align center
:caption Logo MK4
:id fig_logo
Blocs de Code
\`\`\`rust
fn main() {
println!("Hello Typst!");
}
\`\`\`
:filename main.rs
:lines true
:highlight 2
:caption Script principal
:align center
Tableaux
| Composant | Langage | Description |
| :--- | :---: | ---: |
| Serveur | Rust | Pipeline de traitement |
| Hardware | VHDL | Contrôle bas niveau |
:caption Matrice des technologies
:compact true
:align center
Citations (Admonitions / Callouts)
Transformez les citations classiques en blocs d'avertissement colorés :
> Il est crucial de vérifier l'alimentation avant le flashage de la carte.
:type warning
(Types supportés : note, info, tip, warning, error)
Actions Globales
Insérez des commandes de mise en page n'importe où dans le texte :
:layout pagebreak
Commandes & Interface
MK4 ajoute 4 boutons pratiques en haut à droite de l'éditeur lors de l'édition d'un fichier Markdown :
- 🔍 Aperçu Typst : Ouvre le panneau de rendu en direct.
- 📄 Aperçu Markdown : Affiche un rendu HTML léger avec vos annotations sous forme de badges visuels.
- 💾 Exporter Typst : Génère et ouvre le fichier
.typ source.
- 🖨️ Exporter PDF : Compile et sauvegarde le document final en PDF.
Prérequis
- Typst CLI doit être installé sur votre machine et accessible via la variable d'environnement
PATH (tapez typst --version dans votre terminal pour vérifier).
Gestion des fichiers temporaires
L'extension crée des fichiers temporaires cachés (.mk4-temp-*) dans le dossier de votre projet pour permettre au moteur Typst de résoudre correctement les chemins de vos images locales. Ces fichiers sont automatiquement nettoyés à la fermeture de l'aperçu ou de VS Code.
