Markdown : Un Guide Simple et Direct

Vous allez apprendre les bases du Markdown. C'est un moyen efficace de formater du texte sans effort excessif.

C'est quoi, le Markdown ?

Le Markdown fonctionne de la manière suivante :

  • Normalement, on utilise un logiciel comme Word
  • On clique sur les boutons "Gras", "Italique", etc.

Avec Markdown, on obtient le même résultat en utilisant des symboles simples.

C'est un système de formatage minimaliste.

Les 3 Éléments Essentiels

1. Les Titres (Les Textes en Grand)

Vous placez un # (dièse) devant votre titre, puis un espace, puis le texte.

# Mon Titre Principal

Cela crée un titre de grande taille.

C'est tout ce qu'il faut savoir pour les titres.

2. Le Gras et l'Italique

Pour mettre du texte en gras :

Vous placez deux astérisques avant et après le texte.

**Ce texte est gras**

Résultat : Ce texte est gras

Pour mettre du texte en italique :

Vous placez une seule astérisque avant et après le texte.

*Ce texte est en italique*

Résultat : Ce texte est en italique

3. Les Listes (Créer des Points)

Pour créer une liste simple :

- Élément 1
- Élément 2
- Élément 3

Résultat :

  • Élément 1
  • Élément 2
  • Élément 3

Important : Vous devez placer un tiret - et un espace avant chaque élément.

Vous Maîtrisez Maintenant Le Markdown

C'est réellement tout ce qu'il est nécessaire de connaître pour débuter.

Il n'y a rien d'autre à retenir au départ.

Votre Premier Document

Essayons quelque chose de simple : une liste de courses.

# Ma liste de courses

- Pain
- **Lait** (urgent !)
- Fromage
- Œufs

Résultat :

Ma liste de courses

  • Pain
  • Lait (urgent !)
  • Fromage
  • Œufs

C'est tout ! Vous venez de créer votre premier document Markdown.

Un Exemple Avancé : Skill pour Claude

Maintenant que vous maîtrisez les bases, voici un exemple de skill professionnel écrit en Markdown :

# Skill Comptabilité : Clôture Mensuelle

## Description
Assistance pour la clôture comptable mensuelle avec checklist standardisée et génération de rapports.

## Quand utiliser ce skill
- Préparation de la clôture mensuelle
- Génération de tableaux de bord financiers
- Vérification des écritures comptables
- Création de rapports pour la direction

## Checklist de clôture

### Étape 1 : Rapprochements
- Vérifier **tous les rapprochements bancaires**
- Valider les comptes fournisseurs
- Contrôler les comptes clients

### Étape 2 : Écritures
- Passer les écritures de régularisation
- Valider les **écritures de paie**
- Vérifier les amortissements

### Étape 3 : Contrôles
- Générer la balance provisoire
- Vérifier les soldes anormaux
- Contrôler la TVA

## Formules Excel courantes

**Totaux mensuels :**
`=SOMME(A1:A12)`

**Moyenne des ventes :**
`=MOYENNE(B2:B13)`

**Vérification d'équilibre :**
`=SI(D15=E15;"OK";"ERREUR")`

## Format des rapports

Le rapport mensuel doit contenir :
1. Résultat du mois
2. Comparatif budget/réalisé
3. Commentaires des écarts significatifs
4. Prévisions mois suivant

Ce skill utilise tous les éléments Markdown que vous avez appris, organisés de manière professionnelle.

Où Utiliser le Markdown

Vous pouvez utiliser le Markdown sur :

  • Discord (dans les messages)
  • Notion (pour prendre des notes)
  • GitHub (pour les projets)
  • Des fichiers texte simples (extension .md)

Les Deux Règles Fondamentales

  1. Toujours un espace après le symbole

    • ✅ # Titre — Correct
    • ❌ #Titre — Incorrect

  2. Laisser une ligne vide entre les sections

    • Cela améliore la lisibilité

Commencer à Pratiquer

Visitez StackEdit : https://stackedit.io/

Fonctionnement :

  • À gauche : vous écrivez en Markdown
  • À droite : vous voyez le résultat immédiatement

Tapez du texte et observez le résultat en temps réel.

Questions Courantes

"Que se passe-t-il si je me trompe ?" Le texte reste lisible. Vous pouvez essayer, corriger, et réessayer.

"Est-ce difficile ?" Non. Le Markdown est conçu pour être accessible.

"Faut-il installer un logiciel ?" Non. StackEdit est gratuit et ne nécessite aucune installation.

Résumé

Formatage souhaité Syntaxe à utiliser
Un titre # Titre
Texte gras **texte**
Texte en italique *texte*
Une liste - Élément

Conclusion

Vous possédez maintenant les connaissances fondamentales du Markdown.

Vous pouvez à présent l'utiliser dans vos documents et communications.