Instruction file imported from TheWatcher01/copilot_power_user (.github/instructions/markdown.instructions.md). Copyright stays with the author.

Instructions Markdown

Structure

• Commencer chaque document par un titre # Titre suivi d'une description courte (1-2 lignes)
• Ajouter une Table des matières (TOC) après l'introduction pour les documents de plus de 3 sections
• Hiérarchie ## → ### → ####, ne jamais sauter un niveau
• Séparer les sections par une ligne vide et un --- horizontal pour les sections majeures

Langue

• Français pour le contenu narratif et explicatif
• Anglais pour le code inline, les blocs de code, les noms de fichiers, les frontmatter YAML, les noms de variables
• Exception : README.md peut utiliser des emojis, tous les autres fichiers Markdown sont sans emojis

Liens

• Utiliser des liens relatifs vers les autres fichiers du workspace
• Format : [texte descriptif](./chemin/relatif.md)
• Pas de liens absolus vers des fichiers locaux
• Vérifier que tous les liens pointent vers des fichiers existants
• Utiliser des ancres pour les liens intra-document : [section](#nom-section)

Blocs de code

• Toujours spécifier le langage après les triple backticks : ```python, ```typescript, ```yaml, ```jsonc
• Les exemples doivent être fonctionnels et copy-paste-ready
• Ajouter des commentaires inline pour expliquer les points non évidents

Frontmatter

• Les fichiers .instructions.md, .prompt.md, .agent.md et SKILL.md doivent avoir un frontmatter YAML valide délimité par ---
• Respecter les champs documentés dans COPILOT-FILES-INDEX.md
• Pas de champs inconnus ou inventés dans le frontmatter

Anti-patterns

• Ne pas dupliquer du contenu — référencer via liens Markdown
• Ne pas créer de fichiers Markdown monolithiques (> 500 lignes)
• Ne pas utiliser de HTML inline sauf nécessité technique (tableaux complexes)
• Ne pas laisser de liens cassés ou de TODOs non résolus