---
title: "Éditeur"
weight: 35
description: "Utilisation de l'éditeur WYSIWYG Markdown de capDoliWiki : barre d'outils, images, mode plein écran et raccourcis clavier."
---

# Éditeur

capDoliWiki utilise l'éditeur WYSIWYG **Milkdown** pour la rédaction des pages wiki. Vous écrivez en Markdown et le résultat est affiché en temps réel dans l'éditeur.

![Éditeur WYSIWYG Milkdown avec la barre d'outils et le contenu en cours de rédaction](screenshots/editeur-wysiwyg.webp)

## Barre d'outils

La barre d'outils fixe en haut de l'éditeur propose les actions suivantes :

| Bouton | Action |
|--------|--------|
| **G** (gras) | Met le texte sélectionné en gras |
| *I* (italique) | Met le texte sélectionné en italique |
| H1, H2, H3 | Applique un niveau de titre |
| Liste à puces | Crée une liste non ordonnée |
| Liste numérotée | Crée une liste ordonnée |
| Lien | Insère un lien hypertexte |
| Code | Insère un bloc de code |
| Séparateur | Insère une ligne horizontale |
| Plein écran | Passe en mode plein écran |

## Syntaxe Markdown

L'éditeur prend en charge le Markdown standard (CommonMark) et les extensions GitHub Flavored Markdown (GFM) :

### Titres

```markdown
# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3
```

### Mise en forme du texte

```markdown
**Texte en gras**
*Texte en italique*
~~Texte barré~~
`Code en ligne`
```

### Listes

```markdown
- Élément de liste à puces
- Deuxième élément

1. Élément de liste numérotée
2. Deuxième élément
```

### Liens et images

```markdown
[Texte du lien](https://exemple.fr)
![Texte alternatif](url-de-l-image.png)
```

### Blocs de code

Entourez votre code de trois backticks en précisant le langage pour activer la coloration syntaxique :

````markdown
```php
echo "Bonjour le monde";
```
````

Les langages pris en charge par la coloration syntaxique (Prism.js) incluent : PHP, JavaScript, Python, Java, C, C++, CSS, HTML, SQL, Bash, JSON, YAML, XML, Markdown et TypeScript.

### Tableaux

```markdown
| Colonne 1 | Colonne 2 |
|-----------|-----------|
| Cellule   | Cellule   |
```

### Citations

```markdown
> Ceci est une citation.
```

### Blocs d'alerte (callouts)

Utilisez la syntaxe `:::type` pour créer des blocs d'alerte visuels :

```markdown
:::info
Ceci est un bloc d'information.
:::

:::tip
Ceci est un conseil.
:::

:::warning
Ceci est un avertissement.
:::

:::danger
Ceci est un message de danger.
:::
```

### Diagrammes Mermaid

Intégrez des diagrammes directement dans vos pages :

````markdown
```mermaid
graph TD
    A[Début] --> B{Condition}
    B -->|Oui| C[Action 1]
    B -->|Non| D[Action 2]
```
````

Les diagrammes Mermaid sont chargés dynamiquement uniquement lorsqu'une page en contient.

## Insertion d'images

### Collage depuis le presse-papiers

La méthode la plus rapide pour insérer une image :

1. Copiez une image dans le presse-papiers (capture d'écran, copie depuis un logiciel, etc.)
2. Positionnez le curseur à l'endroit souhaité dans l'éditeur
3. Appuyez sur **Ctrl+V**

L'image est automatiquement uploadée sur le serveur, redimensionnée si elle dépasse la [largeur maximale configurée](/view.php?path=capdoliwiki/configuration.md), et insérée dans le contenu.

### Glisser-déposer

Vous pouvez également faire glisser une image depuis votre explorateur de fichiers directement dans l'éditeur.

## Mode plein écran

Cliquez sur le bouton **Plein écran** de la barre d'outils ou utilisez le raccourci **Ctrl+Shift+F** pour passer en mode plein écran. Ce mode masque l'interface Dolibarr et affiche l'éditeur sur toute la surface de l'écran.

Appuyez sur **Échap** pour quitter le mode plein écran.

## Sauvegarde automatique (brouillon)

L'éditeur enregistre automatiquement le contenu en cours de rédaction dans le stockage local du navigateur (localStorage). L'intervalle de sauvegarde est [configurable](/view.php?path=capdoliwiki/configuration.md) (30 secondes par défaut).

Si vous fermez accidentellement le navigateur ou si la connexion est interrompue, le brouillon est restauré automatiquement à la prochaine ouverture de la page d'édition.

> **Attention :** Le brouillon est stocké localement dans votre navigateur. Il n'est pas partagé entre différents navigateurs ou postes de travail.

## Verrouillage

Lorsque vous ouvrez une page en édition, un verrou est automatiquement posé pour empêcher un autre utilisateur de modifier la même page simultanément. Le verrou est :

- **Prolongé automatiquement** tant que l'éditeur reste ouvert (mécanisme de heartbeat)
- **Libéré** lorsque vous sauvegardez ou quittez la page d'édition
- **Expiré** après la durée de verrouillage configurée si le heartbeat ne fonctionne plus (navigateur fermé brutalement, perte de connexion)

Si vous tentez de modifier une page verrouillée par un autre utilisateur, un message d'avertissement vous indique le nom de la personne ayant verrouillé la page.

![Message de verrouillage indiquant qu'un autre utilisateur est en train de modifier la page](screenshots/verrouillage-edition.webp)

Les utilisateurs ayant la permission de suppression/administration peuvent forcer le déverrouillage d'une page.

## Raccourcis clavier

### En mode édition

| Raccourci | Action |
|-----------|--------|
| Ctrl+S | Soumettre le formulaire (sauvegarder la page) |
| Ctrl+Shift+F | Basculer en mode plein écran |
| Échap | Quitter le mode plein écran |

### En mode lecture

| Raccourci | Action |
|-----------|--------|
| E | Ouvrir l'éditeur sur la page courante |
| H | Accéder à l'historique de la page |
| Flèches gauche/droite | Naviguer entre les pages (page précédente/suivante) |