Markdown-Editor selbst hosten: auf Webspace, mit Docker oder nginx

Ein selbst gehosteter Markdown-Editor gibt Ihrem Team ein einheitliches, vertrautes Werkzeug unter Ihrer eigenen Domain – ohne Konten, ohne Abos und ohne Abhängigkeit davon, dass der Dienst eines anderen online bleibt. Ist der Editor eine statische Web-App, ist das Hosting so einfach wie das Hosten einiger HTML-Dateien: Es gibt keine Datenbank zu pflegen, keinen serverseitigen Code zu aktualisieren und fast keine Last auf dem Server.

Als Beispiel dient in dieser Anleitung der Markdown Preview Editor. Er ist kostenlos und Open Source (MIT), und dieselben Schritte gelten für jede statische Webanwendung.

Warum einen Markdown-Editor selbst hosten?

• Ihre Domain, Ihre Regeln. Der Editor ist unter einer Adresse erreichbar, die Sie kontrollieren, zum Beispiel markdown.your-company.com, und funktioniert für alle Nutzer gleich.
• Nichts zu warten. Eine statische Website hat kein Backend – also keine Sicherheitspatches für Servercode und keine Datenbank-Backups.
• Dokumente bleiben lokal. Der Markdown Preview Editor stellt alles im Browser der Besucher dar. Der Server liefert nur die Dateien der App aus – die Dokumente erhält er nie.
• Der Betrieb ist kostenlos. Jeder Webspace-Tarif, ein kleiner VPS oder eine Container-Plattform genügt.

Was Sie brauchen

Einen beliebigen Webserver, der statische Dateien über HTTPS ausliefern kann:

• Webspace (Shared Hosting) mit cPanel, Plesk oder DirectAdmin (Apache oder LiteSpeed),
• einen Server mit Docker,
• nginx oder Caddy auf einem VPS,
• oder sogar Ihren eigenen Computer für die lokale Nutzung.

PHP, Node.js oder eine Datenbank sind auf dem Server nicht nötig.

Option 1: Webspace (cPanel und ähnliche)

Das ist der schnellste Weg, und Sie brauchen keine Kommandozeile.

1. Website-Archiv herunterladen. Laden Sie markdown-preview-editor-site.zip aus dem neuesten Release herunter. Es enthält die fertig gebaute Website.
2. Adresse wählen. Verwenden Sie Ihre Hauptdomain oder legen Sie im Control Panel des Hostings eine Subdomain wie markdown.example.com an. Notieren Sie sich den Ordner Document Root der Subdomain.
3. HTTPS aktivieren. Die meisten Hoster stellen kostenlose Zertifikate automatisch aus (AutoSSL oder Let’s Encrypt). Stellen Sie sicher, dass das Zertifikat für die Domain oder Subdomain aktiv ist.
4. Hochladen und entpacken. Öffnen Sie den Dateimanager, wechseln Sie in das Document Root, laden Sie die ZIP-Datei hoch und wählen Sie Entpacken. Die Dateien – einschließlich der versteckten .htaccess – müssen direkt im Document Root liegen, nicht in einem Unterordner.
5. Domain öffnen. Der Editor ist einsatzbereit.

Die mitgelieferte .htaccess leitet HTTP auf HTTPS um, setzt Sicherheits-Header und konfiguriert das Caching auf Apache- und LiteSpeed-Servern.

Option 2: Docker

Wenn Sie Container betreiben, klonen Sie das Repository und starten Sie die mitgelieferte Compose-Datei:

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

Öffnen Sie http://localhost:8080 – oder den Port, den Sie gewählt haben. Das Image baut die Website und liefert sie mit nginx und denselben Sicherheits-Headern aus. Für eine öffentliche Domain stellen Sie den Container hinter Ihren üblichen Reverse Proxy mit HTTPS.

Option 3: nginx

Bauen Sie die Website (oder entpacken Sie das Release-Archiv) und kopieren Sie die Dateien in Ihr Web-Root:

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

Das Repository enthält unter deploy/nginx.conf eine fertige Konfiguration mit Sicherheits-Headern und Caching-Regeln. Der Kern einer Konfiguration für eine statische Website ist kurz:

nginxserver {
    listen 443 ssl;
    server_name markdown.example.com;
    # hier kommen die Zeilen ssl_certificate und ssl_certificate_key hin

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

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

Laden Sie nginx mit sudo nginx -s reload neu und öffnen Sie die Domain.

Option 4: Caddy

Caddy besorgt HTTPS-Zertifikate automatisch und ist damit die einfachste Option für einen VPS:

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

Kopieren Sie vorher die gebauten Dateien nach /srv; die mitgelieferte Caddyfile liefert sie mit denselben Headern aus wie die anderen Optionen.

Option 5: Lokal ausführen

Für den persönlichen Gebrauch brauchen Sie überhaupt keinen Server:

bashnpm ci
npm run dev

Öffnen Sie die ausgegebene lokale Adresse in Ihrem Browser.

Auf dem neuesten Stand bleiben

Eine statische Website zu aktualisieren heißt, ihre Dateien zu ersetzen. Laden Sie das neue Release-Archiv herunter, entpacken Sie es über die alten Dateien und laden Sie die Seite neu. Da die Dateinamen der App Inhalts-Hashes enthalten, übernehmen Browser die neue Version ohne veraltete Caches. Beobachten Sie das GitHub-Repository (Watch → Custom → Releases), um über neue Versionen benachrichtigt zu werden.

Checkliste nach dem Deployment

• Die Website öffnet sich über https://, und http:// leitet dorthin um.
• Ziehen Sie eine Markdown-Datei auf den Editor – sie öffnet sich in einem neuen Tab.
• Wechseln Sie in den Einstellungen Design und Sprache.
• Exportieren Sie ein Testdokument als HTML, um zu prüfen, ob Downloads funktionieren.

Sobald Ihr Editor live ist, teilen Sie den Markdown-Spickzettel mit Ihrem Team und merken Sie sich unsere Anleitungen zur Markdown-Vorschau und zum Export als HTML und PDF.