Fichier .md : comprendre Markdown et son rôle dans Ouvrali

Du texte lisible sans outil spécial

Markdown est une façon d’organiser un document en texte simple. Les dièses annoncent les titres, les puces forment une liste et des crochets permettent d’écrire un lien. Le fichier reste lisible avant sa mise en forme, comme le souhaitait son créateur, John Gruber.

Le suffixe .md signale ce format. Un éditeur de texte ouvre la source ; un lecteur Markdown en affiche le rendu. La spécification CommonMark définit la lecture de cette syntaxe.

Le même contenu en source et en rendu

# Atelier de réparation

## À confirmer
* Salle du Canal avant le 18 novembre.

## Décision ouverte
Programme à choisir le 20 novembre.

[CommonMark](https://spec.commonmark.org/0.31.2/)

La présentation change ; la décision reste la même. Récupérer cette source (.md).

Pourquoi ce format est pratique avec GPT

Le texte et les repères restent explicites. Vous pouvez demander : « Relis seulement la section À confirmer et indique ce qu’il manque. » Vous désignez un passage que vous pouvez aussi examiner vous-même.

Vous pouvez modifier la source dans un éditeur simple, la transmettre à une IA qui peut lire le fichier et retrouver ce qui a changé entre deux versions. Aucun logiciel de mise en page particulier n’est nécessaire pour écrire le contenu.

Cette simplicité rend les consignes faciles à partager et à reprendre. La qualité de la réponse dépend toujours du modèle, des sources et du travail demandé ; l’extension .md ne garantit pas une réponse exacte.

Comment nous construisons la qualité d’Ouvrali

Nous gardons le besoin dans la référence du site, la manière de travailler dans une méthode éditoriale et les constats dans les relectures. Ces documents Markdown nous servent de base commune.

1. Écrire le besoin : expliquer les projets et les fichiers de ChatGPT aux débutants.
2. Fixer les consignes : consulter les sources officielles et montrer les étapes utiles.
3. Relire indépendamment : un lecteur relève que « le projet donne accès au dossier » généralise une capacité locale.
4. Corriger : préciser « projet local avec dossier rattaché » et « projet web avec sources ajoutées ou connectées ».
5. Contrôler : relire la correction et régénérer la vue HTML depuis la source Markdown.

Lire l’extrait public reformulé de cette correction (.md). Le fichier garde la décision consultable ; les sources, la relecture et la vérification font progresser le contenu.

Un format commun, plusieurs rôles

Un fichier Markdown ordinaire est un document à fournir ou à rendre accessible. Certaines conventions lui donnent un rôle particulier : AGENTS.md porte des instructions découvertes par Codex ; SKILL.md décrit une méthode avec un nom et une description. Le suffixe seul ne déclenche pas ces rôles.

Ouvrali utilise aussi des textes modifiables pour le contexte et le suivi de vos dossiers. Découvrez les skills pour comprendre une méthode enregistrée, ou les fichiers et artefacts pour choisir un livrable à remettre.

Une demande à adapter à votre activité

Lis ce fichier Markdown. Repère ses titres, les décisions confirmées et les questions ouvertes. Explique la section [nom] avec des mots simples. Si une correction est utile, propose-la en indiquant la source et ce qu’elle change.

Les questions pratiques

Pour poursuivre

Avec Ouvrali

Fichiers et artefacts dans ChatGPT

Comparez les formats, ouvrez trois fichiers d’un même atelier et voyez une correction demandée dans ChatGPT.

Lire l’article →

Avec Ouvrali

Créer et réutiliser une skill

Une méthode conservée, deux nouvelles fiches et des questions différentes : découvrez comment réutiliser une skill.

Lire l’article →

Revenir à toutes les lectures