Auto-héberger un éditeur Markdown : hébergement mutualisé, Docker ou nginx

Un éditeur Markdown auto-hébergé offre à votre équipe un outil unique et familier sur votre propre domaine — sans comptes, sans abonnements et sans dépendre de la disponibilité du service de quelqu’un d’autre. Si l’éditeur est une application web statique, l’héberger est aussi simple qu’héberger quelques fichiers HTML : pas de base de données à entretenir, pas de code serveur à mettre à jour et quasiment aucune charge sur le serveur.

Ce guide prend Markdown Preview Editor comme exemple. Il est gratuit et open source (MIT), et les mêmes étapes s’appliquent à n’importe quelle application web statique.

Pourquoi auto-héberger un éditeur Markdown ?

• Votre domaine, vos règles. L’éditeur est accessible à une adresse que vous contrôlez, par exemple markdown.your-company.com, et il fonctionne de la même façon pour tous ses utilisateurs.
• Rien à maintenir. Un site statique n’a pas de backend : pas de correctifs de sécurité pour du code serveur, pas de sauvegardes de base de données.
• Les documents restent en local. Markdown Preview Editor effectue tout le rendu dans le navigateur du visiteur. Le serveur ne fait que livrer les fichiers de l’application : il ne reçoit jamais les documents.
• Son fonctionnement ne coûte rien. N’importe quelle offre d’hébergement mutualisé, un petit VPS ou une plateforme de conteneurs suffit.

Ce dont vous avez besoin

N’importe quel serveur web capable de servir des fichiers statiques en HTTPS :

• un hébergement mutualisé avec cPanel, Plesk ou DirectAdmin (Apache ou LiteSpeed),
• un serveur avec Docker,
• nginx ou Caddy sur un VPS,
• ou même votre propre ordinateur, pour un usage local.

Ni PHP, ni Node.js, ni base de données ne sont nécessaires sur le serveur.

Option 1 : hébergement mutualisé (cPanel et similaires)

C’est la méthode la plus rapide, et elle ne demande aucune ligne de commande.

1. Téléchargez l’archive du site. Récupérez markdown-preview-editor-site.zip dans la dernière version. Elle contient le site déjà compilé.
2. Choisissez l’adresse. Utilisez votre domaine principal ou créez un sous-domaine comme markdown.example.com dans le panneau de contrôle de l’hébergement. Notez le dossier racine du document (document root) du sous-domaine.
3. Activez le HTTPS. La plupart des hébergeurs délivrent automatiquement des certificats gratuits (AutoSSL ou Let’s Encrypt). Vérifiez que le certificat est actif pour le domaine ou le sous-domaine.
4. Envoyez et décompressez. Ouvrez le Gestionnaire de fichiers, allez à la racine du document, envoyez le fichier zip et choisissez Extraire. Les fichiers — y compris le fichier caché .htaccess — doivent se trouver directement à la racine du document, pas dans un sous-dossier.
5. Ouvrez votre domaine. L’éditeur est prêt.

Le fichier .htaccess fourni redirige le HTTP vers le HTTPS, définit des en-têtes de sécurité et configure le cache sur les serveurs Apache et LiteSpeed.

Option 2 : Docker

Si vous utilisez des conteneurs, clonez le dépôt et lancez le fichier Compose fourni :

bashgit clone https://github.com/ovasendin/markdown_preview_editor.git
cd markdown_preview_editor
PORT=8080 docker compose -f deploy/docker-compose.yml up -d --build

Ouvrez http://localhost:8080 — ou le port que vous avez choisi. L’image compile le site et le sert avec nginx et les mêmes en-têtes de sécurité. Pour un domaine public, placez le conteneur derrière votre reverse proxy habituel avec HTTPS.

Option 3 : nginx

Compilez le site (ou décompressez l’archive de la version) et copiez les fichiers dans la racine web :

bashnpm ci && npm run build
sudo cp -r dist/* /var/www/markdown/

Le dépôt contient une configuration prête à l’emploi dans deploy/nginx.conf, avec les en-têtes de sécurité et les règles de cache. L’essentiel d’une configuration de site statique tient en quelques lignes :

nginxserver {
    listen 443 ssl;
    server_name markdown.example.com;
    # les lignes ssl_certificate et ssl_certificate_key vont ici

    root /var/www/markdown;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Rechargez nginx avec sudo nginx -s reload et ouvrez le domaine.

Option 4 : Caddy

Caddy obtient automatiquement les certificats HTTPS, ce qui en fait l’option la plus simple sur un VPS :

bashSITE_ADDRESS=markdown.example.com caddy run --config deploy/Caddyfile

Copiez d’abord les fichiers compilés dans /srv ; le Caddyfile fourni les sert avec les mêmes en-têtes que les autres options.

Option 5 : l’exécuter en local

Pour un usage personnel, vous n’avez même pas besoin de serveur :

bashnpm ci
npm run dev

Ouvrez dans votre navigateur l’adresse locale affichée.

Mettre à jour

Mettre à jour un site statique revient à remplacer ses fichiers. Téléchargez l’archive de la nouvelle version, décompressez-la par-dessus les anciens fichiers et rechargez la page. Comme les noms de fichiers de l’application contiennent des empreintes de contenu, les navigateurs récupèrent la nouvelle version sans cache périmé. Suivez le dépôt GitHub (Watch → Custom → Releases) pour être averti des nouvelles versions.

Check-list après le déploiement

• Le site s’ouvre en https:// et http:// redirige vers celui-ci.
• Faites glisser un fichier Markdown sur l’éditeur : il s’ouvre dans un nouvel onglet.
• Changez le thème et la langue dans les paramètres.
• Exportez un document de test en HTML pour vérifier que les téléchargements fonctionnent.

Une fois votre éditeur en ligne, partagez l’aide-mémoire Markdown avec votre équipe et gardez sous la main nos guides sur l’aperçu du Markdown et l’export en HTML et en PDF.