# 🖥️ Guide Markdown — Tips Windows & Linux

> Un fichier de démonstration pour tester le rendu Markdown dans **Notepad++**, MarkdownViewer++, VS Code, MarkText, GitHub, etc.

---

# 1. Les titres

# Titre niveau 1

## Titre niveau 2

### Titre niveau 3

#### Titre niveau 4

##### Titre niveau 5

###### Titre niveau 6

---

# 2. Mise en forme du texte

Texte normal.

**Texte en gras**

*Texte en italique*

***Texte en gras et italique***

~~Texte barré~~

Voici du `code directement dans une phrase`.

On peut aussi combiner : **une commande `ipconfig` importante**.

---

# 3. Citations

> 💡 **Astuce Windows**
>
> La commande `winget` permet d'installer et de mettre à jour des logiciels depuis le terminal.

Citation imbriquée :

> Niveau 1
>
> > Niveau 2
> >
> > > Niveau 3

---

# 4. Listes à puces

Quelques commandes Windows utiles :

* `ipconfig`
* `ping`
* `nslookup`
* `netstat`
* `systeminfo`

Sous-listes :

* Réseau

  * `ipconfig /all`
  * `ping google.com`
  * `nslookup google.com`
* Système

  * `systeminfo`
  * `tasklist`
  * `whoami`

---

# 5. Listes numérotées

Pour diagnostiquer un problème réseau :

1. Vérifier son adresse IP.
2. Tester la passerelle.
3. Tester une IP Internet.
4. Tester un nom DNS.
5. Vérifier les serveurs DNS.

Exemple :

1. `ipconfig`
2. `ping 192.168.1.1`
3. `ping 1.1.1.1`
4. `ping google.com`
5. `nslookup google.com`

---

# 6. Cases à cocher

Checklist après installation d'un PC :

* [x] Installer Windows
* [x] Installer les pilotes
* [ ] Installer les applications
* [ ] Configurer les sauvegardes
* [ ] Vérifier Windows Update
* [ ] Tester le VPN

---

# 7. Liens

Site Microsoft :

[Microsoft](https://www.microsoft.com)

Documentation PowerShell :

[Documentation PowerShell](https://learn.microsoft.com/powershell/)

Documentation Ubuntu :

[Documentation Ubuntu](https://help.ubuntu.com/)

Lien affiché directement :

https://github.com/

---

# 8. Images

Image distante :

![Logo Linux](https://upload.wikimedia.org/wikipedia/commons/a/af/Tux.png)

Image locale :

```markdown
![Capture d'écran](./images/capture.png)
```

---

# 9. Séparateurs

Trois tirets :

---

Trois étoiles :

---

Trois underscores :

---

---

# 10. Code PowerShell

```powershell
# Informations système
Get-ComputerInfo

# Adresse IP
Get-NetIPAddress

# Processus consommant le plus de CPU
Get-Process |
    Sort-Object CPU -Descending |
    Select-Object -First 10

# Espace disque
Get-Volume
```

---

# 11. Code Bash / Linux

```bash
# Informations système
uname -a

# Distribution Linux
cat /etc/os-release

# Adresse IP
ip addr

# Espace disque
df -h

# Mémoire
free -h

# Processus
ps aux
```

---

# 12. Code CMD

```cmd
REM Informations réseau
ipconfig /all

REM Tester Internet
ping 1.1.1.1

REM Tester le DNS
nslookup google.com

REM Informations système
systeminfo

REM Utilisateur actuel
whoami
```

---

# 13. Bloc de texte brut

```text
Serveur     : SRV-FILES-01
IP          : 192.168.10.20
OS          : Ubuntu Server
Port SSH    : 22
Service     : Samba
```

---

# 14. Tableaux

## Commandes réseau

| Action      | Windows        | Linux          |
| ----------- | -------------- | -------------- |
| Voir les IP | `ipconfig`     | `ip addr`      |
| Ping        | `ping 1.1.1.1` | `ping 1.1.1.1` |
| DNS         | `nslookup`     | `dig`          |
| Connexions  | `netstat -ano` | `ss -tunap`    |
| Route       | `tracert`      | `traceroute`   |
| Table ARP   | `arp -a`       | `ip neigh`     |

---

# 15. Alignement dans les tableaux

| Gauche  |     Centre    | Droite |
| :------ | :-----------: | -----: |
| Windows |   Windows 11  |   24H2 |
| Ubuntu  | Ubuntu Server |  24.04 |
| Debian  |     Debian    |     13 |

---

# 16. Astuce Windows — trouver son IP publique

Avec PowerShell :

```powershell
Invoke-RestMethod https://api.ipify.org
```

Avec `curl` :

```powershell
curl.exe https://api.ipify.org
```

---

# 17. Astuce Linux — trouver les gros fichiers

Afficher les fichiers et dossiers les plus volumineux :

```bash
du -ah /var 2>/dev/null | sort -rh | head -20
```

Pour l'espace disque :

```bash
df -h
```

---

# 18. Astuce Windows — logiciels installés avec Winget

Lister les applications :

```powershell
winget list
```

Rechercher une application :

```powershell
winget search powertoys
```

Installer PowerToys :

```powershell
winget install Microsoft.PowerToys
```

Mettre à jour les applications :

```powershell
winget upgrade --all
```

---

# 19. Astuce Linux — APT

Mettre à jour la liste des paquets :

```bash
sudo apt update
```

Mettre à jour le système :

```bash
sudo apt upgrade
```

Rechercher un paquet :

```bash
apt search nginx
```

Installer un paquet :

```bash
sudo apt install nginx
```

Supprimer un paquet :

```bash
sudo apt remove nginx
```

---

# 20. Échappement des caractères Markdown

Pour afficher des caractères Markdown sans les interpréter :

*pas en italique*

# pas un titre

> pas une citation

`pas du code`

---

# 21. HTML dans Markdown

Certains moteurs Markdown acceptent également du HTML.

<details>
<summary>👉 Cliquer pour afficher une astuce</summary>

### Commande cachée

Pour connaître le nom du PC sous Windows :

```powershell
hostname
```

Sous Linux :

```bash
hostnamectl
```

</details>

---

# 22. Notes / avertissements façon GitHub

> [!NOTE]
> Cette syntaxe fonctionne notamment sur GitHub, mais pas forcément dans tous les lecteurs Markdown.

> [!TIP]
> Utilise `Ctrl + Shift + Esc` sous Windows pour ouvrir directement le Gestionnaire des tâches.

> [!IMPORTANT]
> Vérifie toujours une commande administrative avant de l'exécuter.

> [!WARNING]
> Une commande lancée avec `sudo` ou en administrateur peut modifier le système.

> [!CAUTION]
> Évite de copier aveuglément des commandes trouvées sur Internet.

---

# 23. Raccourcis Windows utiles

| Raccourci            | Action                       |
| -------------------- | ---------------------------- |
| `Win + E`            | Explorateur de fichiers      |
| `Win + R`            | Exécuter                     |
| `Win + I`            | Paramètres                   |
| `Win + L`            | Verrouiller le PC            |
| `Win + V`            | Historique du presse-papiers |
| `Win + Shift + S`    | Capture d'écran              |
| `Ctrl + Shift + Esc` | Gestionnaire des tâches      |
| `Win + X`            | Menu système                 |

---

# 24. Variables d'environnement

## Windows PowerShell

```powershell
$env:USERNAME
$env:COMPUTERNAME
$env:USERPROFILE
$env:TEMP
$env:PATH
```

## Linux

```bash
echo "$USER"
echo "$HOME"
echo "$SHELL"
echo "$PATH"
```

---

# 25. Exemple de fiche serveur

## 🗄️ SRV-WEB-01

**Rôle :** Serveur Web
**OS :** Ubuntu Server
**IP :** `192.168.10.50`
**Environnement :** Production

### Services

* [x] SSH
* [x] Nginx
* [x] PHP
* [ ] Docker

### Connexion

```bash
ssh admin@192.168.10.50
```

### Vérification Nginx

```bash
sudo systemctl status nginx
```

### Logs

```bash
sudo journalctl -u nginx
```

> ⚠️ **Attention :** serveur de production. Ne pas redémarrer sans vérifier les utilisateurs connectés.

---

# 26. Exemple d'arborescence

```text
📁 documentation/
├── 📁 windows/
│   ├── reseau.md
│   ├── powershell.md
│   └── dépannage.md
├── 📁 linux/
│   ├── bash.md
│   ├── ssh.md
│   └── docker.md
├── 📁 images/
│   └── schema-reseau.png
└── README.md
```

---

# 27. Petite antisèche

| Syntaxe           | Résultat        |
| ----------------- | --------------- |
| `# Titre`         | Titre H1        |
| `## Titre`        | Titre H2        |
| `**texte**`       | Gras            |
| `*texte*`         | Italique        |
| `~~texte~~`       | Barré           |
| `` `commande` ``  | Code inline     |
| `> texte`         | Citation        |
| `- élément`       | Liste           |
| `1. élément`      | Liste numérotée |
| `- [ ] tâche`     | Case à cocher   |
| `[texte](url)`    | Lien            |
| `![texte](image)` | Image           |
| `---`             | Séparateur      |
| ` ```bash `       | Bloc de code    |

---

# 🎯 Conclusion

Markdown est particulièrement pratique pour créer :

* 📚 de la documentation technique ;
* 🖥️ des fiches Windows/Linux ;
* 🌐 de la documentation réseau ;
* 🐳 des procédures Docker ;
* 📝 des README ;
* 🔧 des procédures de dépannage ;
* ☑️ des checklists ;
* 📋 des comptes rendus ;
* 💾 des fiches serveurs ;
* 🚀 des procédures de déploiement.

> 💡 **Conseil :** crée un dossier de documentation avec un fichier `README.md` principal et plusieurs sous-fichiers spécialisés. Ça devient rapidement une petite base de connaissances personnelle.