Titres et hiérarchie

Le langage Markdown utilise le caractère dièse (#) pour définir les niveaux de titres. Le nombre de dièses détermine le niveau hiérarchique, allant du niveau 1 (le plus important) au niveau 6 (le moins important).

Structure des paragraphes

Les paragraphes se séparent par une ligne vide. Un simple retour à la ligne ni'nterrompt pas un paragraphe.

Mise en forme du texte

L'astérisque (*) ou le trait de soulignement (_) permettent de modifier l'apparence du texte :

• Texte en italique : un seul caractère
• Texte en gras : deux caractères consécutifs

Listes et énumérations

Listes non ordonnées

Les symboles *, + ou - créent des listes à puces :

• Premier élément
• Deuxième élément
• Troisième élément

Listes ordonnées

Un chiffre suivi d'un point crée une liste numérotée :

1. Première étape
2. Deuxième étape
3. Troisième étape

Liens et images

La syntaxe pour un lien est : [texte visible](url)

Pour insérer une image, ajoutez un point d'exclamation : ![texte alternatif](url_image)

Blocs de code

Les accents graves (```) délimitent le code inline. Pour un bloc multiligne, utilisez triple accent :

def afficher_message():
    print("Bienvenue dans Markdown!")

afficher_message()

Séparateurs horizontaux

Trois traits d'union ou astérisques créent une ligne horizontale :

Syntaxe étendue

Tableaux

Le pipe (|) sépare les colonnes, tandis que les tirets définissent l'en-tête :

Listes de tâches

• Tâche en attente
• Tâche complétée

Texte barré

Le double tilde (~~) barre le texte : contenu obsolète

Formules mathématiques

Markdown supporte la syntaxe LaTeX avec $ pour les formules inline et $$ pour les blocs :

Exemple de formule : $\sum_{k=1}^{n} k = \frac{n(n+1)}{2}$

Fonctionnalités avancées

Diagrammes et schémas

Markdown ne possède pas de fonctionnalités natives pour le dessin, mais des extensions comme Mermaid permettent d'intégrer des diagrammes directement dans le document.

Conversion de formats

Les fichiers Markdown se convertissent aisément en HTML, PDF ou documents Word grâce à des outils comme Pandoc ou les fonctionnalités d'export des éditeurs modernes.

Présentations

Des outils comme Marp ou reveal.js transforment le Markdown en présentations interactives, facilitant la création de slides sans quitter l'éditeur de texte.

Structure de document type

En-tête standard

---
title: Titre du document
author: Auteur
date: YYYY-MM-DD
---

Organisation recommandée

1. Introduction : Contexte et objectifs
2. Développement : Contenu principal avec sous-sections
3. Références : Sources et documentation

Exemple de section avec code intégré

// Exemple en JavaScript moderne
const calculerSomme = (nombres) => {
    return nombres.reduce((acc, val) => acc + val, 0);
};

const resultat = calculerSomme([10, 20, 30]);
console.log(`Total: ${resultat}`);