# Markdown dans le terminal

Ouvrez un fichier `.md` ou `.markdown` avec Elide pour le lire comme un document
formaté dans le terminal. Utilisez-le pour le README d'un dépôt, un runbook d'exploitation via SSH ou des notes de
développement sans quitter le shell. Aucun projet Elide n'est requis.

## Lire un README ou un runbook

```shell
elide README.md
elide docs/runbook.md
elide run notes.markdown
```

Les titres établissent une hiérarchie visuelle ; listes, citations, tableaux et panneaux de code rendent les longs
documents plus faciles à parcourir. Le texte s'adapte à la largeur du terminal, et les blocs de code délimités
reçoivent une coloration syntaxique pour les langages reconnus. Les blocs de code sont affichés, pas exécutés.

La syntaxe CommonMark est prise en charge, ainsi que les tableaux, le texte barré et les listes de tâches de style
GitHub. Par exemple, enregistrez ceci sous `runbook.md` :

````markdown
# Check the service

- [x] Generate configuration
- [ ] Verify the health endpoint

```shell
curl http://localhost:8080/health
```

| Response | Next step |
| --- | --- |
| 200 | Continue deployment |
| 503 | Check application logs |
````

Puis lancez `elide runbook.md`. Les liens conservent leurs destinations, et le HTML brut est affiché comme du texte.

## Parcourir un long document

Elide écrit le document rendu sur stdout. Redirigez-le vers un pager comme `less` pour faire défiler :

```shell
elide docs/runbook.md | less
```

La sortie redirigée est brute par défaut. Pour conserver les couleurs du terminal avec un pager qui comprend les
séquences d'échappement ANSI :

```shell
elide --color docs/runbook.md | less -R
```

`--no-color` et la variable d'environnement `NO_COLOR` l'emportent sur la couleur forcée. Si `NO_COLOR` est définie,
retirez-la de l'environnement avant d'utiliser l'exemple en couleur.

## Enregistrer une copie texte lisible

Désactivez explicitement les couleurs pour enregistrer des notes rendues dans un journal ou un artefact :

```shell
elide --no-color notes.markdown > notes.txt
```

Cela écrit le rendu du terminal, mise en page comprise, au lieu de convertir le Markdown vers un autre format de
document. Le fichier source reste inchangé. `--quiet` conserve aussi la sortie rendue.

`--format` sert à la [sortie Pkl et PCF](/docs/pkl-configuration) et est refusé pour les fichiers Markdown. Le rendu de
documents refuse aussi `--sandbox` et `--limit`. Voir la [référence de la CLI](/docs/cli-references) pour les options de la
commande.