137 lines
5.0 KiB
Markdown
137 lines
5.0 KiB
Markdown
---
|
||
title: HedgeDoc
|
||
created: 2026-06-07
|
||
updated: 2026-06-07
|
||
type: app
|
||
tags: [catalogue, note-taking, collaboration, markdown, hedgedoc, realtime, docker]
|
||
confidence: high
|
||
contested: false
|
||
sources: [https://selfh.st/apps/?tag=Note-Taking, https://hedgedoc.org, https://docs.hedgedoc.org/setup/getting-started, https://github.com/hedgedoc/hedgedoc]
|
||
---
|
||
|
||
# 🤝 HedgeDoc
|
||
|
||
> **L’éditeur Markdown collaboratif en temps réel** : partage par lien, révisions, permissions simples et usage immédiat dans le navigateur.
|
||
|
||
## 📋 Informations Générales
|
||
|
||
| Champ | Valeur |
|
||
| :--- | :--- |
|
||
| **Site web** | [hedgedoc.org](https://hedgedoc.org) |
|
||
| **GitHub** | [hedgedoc/hedgedoc](https://github.com/hedgedoc/hedgedoc) |
|
||
| **Licence** | AGPL-3.0 |
|
||
| **Langage** | TypeScript |
|
||
| **Étoiles GitHub** | 7.2k ⭐ |
|
||
| **Dernière MAJ** | 2026-05-19 |
|
||
| **Catégorie** | [[cat-note-taking|Note-Taking]] |
|
||
|
||
## 📝 Description
|
||
|
||
**HedgeDoc** est un éditeur **Markdown collaboratif en temps réel** auto-hébergeable, historiquement issu de la lignée **HackMD / CodiMD**. L’application se concentre sur un cas d’usage clair : **écrire à plusieurs dans le navigateur**, sans installer de client natif, avec un rendu Markdown vivant et un partage simple par URL.
|
||
|
||
Le produit n’est pas un PKM personnel complexe à la Obsidian ; il excelle plutôt comme **bloc-notes collaboratif**, support de réunions, prise de notes d’équipe, rédaction conjointe de procédures, documents temporaires ou présentations Markdown. Le site officiel met aussi en avant les **révisions**, le **mode présentation** et la prise en charge de **diagrammes**.
|
||
|
||
HedgeDoc convient surtout à :
|
||
|
||
- des **notes collaboratives** ;
|
||
- des **comptes-rendus de réunion** ;
|
||
- des **documents techniques partagés** ;
|
||
- des ateliers, formations ou événements où plusieurs personnes éditent en direct.
|
||
|
||
Points notables :
|
||
|
||
- ✅ **Collaboration temps réel**
|
||
- ✅ **Markdown** dans le navigateur
|
||
- ✅ **Révisions** et historique
|
||
- ✅ **Permissions** simples
|
||
- ✅ **Mode présentation**
|
||
- ✅ Ressources modestes, y compris sur petites machines
|
||
|
||
## 🚀 Installation
|
||
|
||
### Option recommandée : Docker Compose
|
||
|
||
Une installation classique repose sur un conteneur HedgeDoc et une base PostgreSQL :
|
||
|
||
```yaml
|
||
services:
|
||
database:
|
||
image: postgres:16-alpine
|
||
restart: unless-stopped
|
||
environment:
|
||
POSTGRES_DB: hedgedoc
|
||
POSTGRES_USER: hedgedoc
|
||
POSTGRES_PASSWORD: CHANGE_ME_DB_PASSWORD
|
||
volumes:
|
||
- ./postgres-data:/var/lib/postgresql/data
|
||
|
||
hedgedoc:
|
||
image: quay.io/hedgedoc/hedgedoc:1.10.8
|
||
restart: unless-stopped
|
||
ports:
|
||
- "3000:3000"
|
||
environment:
|
||
CMD_DB_URL: postgres://hedgedoc:CHANGE_ME_DB_PASSWORD@database:5432/hedgedoc
|
||
CMD_DOMAIN: notes.example.com
|
||
CMD_URL_ADDPORT: false
|
||
CMD_PROTOCOL_USESSL: true
|
||
depends_on:
|
||
- database
|
||
```
|
||
|
||
Puis :
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
### Point d’attention produit
|
||
|
||
Le projet rappelle que **HedgeDoc 1.x** est stable mais en **maintenance**, tandis que **HedgeDoc 2** est une réécriture en cours. Pour un homelab pragmatique, la branche 1.x reste la référence de déploiement aujourd’hui.
|
||
|
||
## ⚙️ Configuration Initiale
|
||
|
||
1. **Déployer la base de données** et HedgeDoc.
|
||
2. **Configurer le domaine** et le **HTTPS** via reverse proxy.
|
||
3. **Choisir le mode d’authentification** voulu : local, OAuth/OIDC, etc.
|
||
4. **Vérifier les permissions** de notes par défaut avant ouverture à un groupe.
|
||
5. **Tester la collaboration** en ouvrant une note depuis plusieurs navigateurs.
|
||
6. **Décider de la politique de conservation** selon que les notes sont temporaires ou durables.
|
||
|
||
## 🔄 Alternatives
|
||
|
||
### Open Source
|
||
- [[app-etherpad]] — Collaboration temps réel plus généraliste, moins centré Markdown
|
||
- [[app-docs-collaboration]] — Suite collaborative plus large
|
||
- [[app-outline]] — Base documentaire d’équipe plus structurée
|
||
- [[app-xwiki]] — Wiki collaboratif beaucoup plus complet
|
||
- **HackMD** — Ancêtre/solution proche, mais plus orientée service hébergé
|
||
|
||
### Propriétaires
|
||
- **Notion**
|
||
- **Confluence**
|
||
- **Google Docs**
|
||
- **HackMD Enterprise**
|
||
|
||
## 🔐 Sécurité
|
||
|
||
- ✅ Placez HedgeDoc derrière **HTTPS**
|
||
- ✅ Utilisez une authentification **SSO/OIDC** si l’instance est ouverte à une équipe
|
||
- ⚠️ Les notes peuvent être partagées par lien : vérifiez les **permissions par défaut**
|
||
- ✅ Sauvegardez la base PostgreSQL et les paramètres applicatifs
|
||
- ⚠️ Si l’instance est publique, surveillez l’abus et le spam
|
||
|
||
## 📚 Ressources
|
||
|
||
- [Site officiel](https://hedgedoc.org)
|
||
- [Documentation](https://docs.hedgedoc.org/)
|
||
- [Guide d’installation](https://docs.hedgedoc.org/setup/getting-started)
|
||
- [GitHub hedgedoc/hedgedoc](https://github.com/hedgedoc/hedgedoc)
|
||
|
||
## Pages Liées
|
||
|
||
- [[cat-note-taking]] — Vue d’ensemble de la catégorie Note-Taking
|
||
- [[app-etherpad]] — Autre éditeur collaboratif temps réel
|
||
- [[app-outline]] — Alternative plus structurée pour équipes
|
||
- [[app-xwiki]] — Alternative wiki complète
|