Aide-mémoire Markdown

Bien qu'il en existe partout sur Internet, voici mon aide-mémoire pour rédiger du Markdown propre et bien structuré.

Titres

Un # suivi d’un espace forme un titre. Le nombre de # détermine le niveau du titre (de 1 à 6).

# Heading 1
 
## Heading 2
 
### Heading 3
 
#### Heading 4

Mise en forme du texte

Il suffit d'entourer les mots avec les symboles appropriés — sans espace à l’intérieur.

Listes

Liste non ordonnée

Il suffit d'utiliser -, * ou + en début de chaque item:

- Item A
- Item B
  - Sub-item B1 (indenter avec 2 or 4 espaces)

• Item A
• Item B
  • Sub-item B1 (indenter avec 2 or 4 espaces)

Liste ordonnée

On commence par un chiffre suivi d’un point.

1. Premier élément
2. Deuxième élément

1. Premier élément
2. Deuxième élément

Liste de tâches

Utilisez - [ ] ou - [x] :

- [ ] Item A
- [x] Item B
- [x] Item C

• Item A
• Item B
• Item C

Hyperliens & images

Hyperliens

[Texte du lien](https://example.com)

Texte du lien

Images Markdown standard

![Alt text](https://example.com/image.png)
![Alt text|100](/images/logo.svg)

Intégration d’images Obsidian

![[image.png]] — intégration standard
![[image.png|300]] — largeur fixe (300 px)
![[image.png#right]] — flottante à droite
![[image.png#right|200]] — flottante à droite + 200px wide

Citations & séparateurs

Citation

> Code is poetry written under constraints.

Code is poetry written under constraints.

Ligne horizontale

---

Blocs de code

Entourez le code de trois backticks et indiquez le langage pour bénéficier de la coloration syntaxique :

```bash
service restart_dnsmasq
```
 
```yaml
light:
  - platform: hue
    bridge_ip: "192.168.1.10"
```
 
```typescript
const slug = fileName.replace(/\.md$/, "");
```

Les langages pris en charge sont notamment bash, yaml, typescript, javascript, python, json, css, html et bien d’autres.

Tableaux

Utilisez - pour les en-têtes et | pour séparer les colonnes :

| Conteneur      |      État      |  Port |
| :------------- | :------------: | ----: |
| Plex           |     Actif      | 32400 |
| Home Assistant | Actif (centré) |  8123 |

Les deux-points contrôlent l’alignement :--- à gauche, :---: centré, ---: à droite.

En-tête

Chaque article commence par un bloc d'en-tête YAML :

---
title: "Mon article"
date: "2026-07-24"
tags: ["tag1", "tag2"]
draft: false
excerpt: "A short description shown on the homepage."
cover: "/images/cover.png"
---

Wikilinks

Crée des liens entre les articles avec les wikilinks de style Obsidian :

[[Article Title]] — lien utilisant le titre
[[Article Title|Custom label]] — lien avec un texte personnalisé

Le lien est résolu automatiquement, quels que soient les accents, la casse ou les espaces dans le nom du fichier.