Så driftar du en egen Markdown-redigerare på webbhotell, Docker eller nginx

En Markdown-redigerare på egen server ger ditt team ett enda välbekant verktyg på er egen domän – inga konton, inga abonnemang och inget beroende av att någon annans tjänst fortsätter att fungera. Om redigeraren är en statisk webbapp är det lika enkelt att drifta den som att lägga upp några HTML-filer: det finns ingen databas att underhålla, ingen serverkod att uppdatera och nästan ingen belastning på servern.

Den här guiden använder Markdown Preview Editor som exempel. Den är gratis och har öppen källkod (MIT), och samma steg fungerar för alla statiska webbapplikationer.

Varför drifta en egen Markdown-redigerare?

• Din domän, dina regler. Redigeraren finns på en adress som du kontrollerar, till exempel markdown.your-company.com, och den fungerar likadant för alla som använder den.
• Inget att underhålla. En statisk webbplats har ingen backend, så det finns inga säkerhetsuppdateringar för serverkod och inga databassäkerhetskopior.
• Dokumenten stannar lokalt. Markdown Preview Editor renderar allt i besökarens webbläsare. Servern levererar bara appens filer – den tar aldrig emot dokumenten.
• Den är gratis att köra. Vilket webbhotell som helst, en liten VPS eller en containerplattform räcker.

Det här behöver du

Valfri webbserver som kan leverera statiska filer via HTTPS:

• ett webbhotell med cPanel, Plesk eller DirectAdmin (Apache eller LiteSpeed),
• en server med Docker,
• nginx eller Caddy på en VPS,
• eller till och med din egen dator för lokal användning.

Ingen PHP, Node.js eller databas behövs på servern.

Alternativ 1: Webbhotell (cPanel och liknande)

Det här är den snabbaste vägen och kräver ingen kommandorad.

1. Ladda ner webbplatsarkivet. Hämta markdown-preview-editor-site.zip från senaste versionen. Den innehåller den färdigbyggda webbplatsen.
2. Välj adress. Använd din huvuddomän eller skapa en underdomän som markdown.example.com i webbhotellets kontrollpanel. Notera underdomänens rotkatalog (document root).
3. Aktivera HTTPS. De flesta webbhotell utfärdar kostnadsfria certifikat automatiskt (AutoSSL eller Let’s Encrypt). Kontrollera att certifikatet är aktivt för domänen eller underdomänen.
4. Ladda upp och packa upp. Öppna File Manager (filhanteraren), gå till rotkatalogen, ladda upp zip-filen och välj Extract (packa upp). Filerna – inklusive en dold .htaccess – måste ligga direkt i rotkatalogen, inte i en undermapp.
5. Öppna din domän. Redigeraren är klar att använda.

Den medföljande .htaccess omdirigerar HTTP till HTTPS, sätter säkerhetsrubriker och konfigurerar cachning på Apache- och LiteSpeed-servrar.

Alternativ 2: Docker

Om du kör containrar klonar du repot och startar den medföljande Compose-filen:

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

Öppna http://localhost:8080 – eller den port du valde. Avbildningen bygger webbplatsen och levererar den med nginx och samma säkerhetsrubriker. För en publik domän placerar du containern bakom din vanliga omvända proxy med HTTPS.

Alternativ 3: nginx

Bygg webbplatsen (eller packa upp versionsarkivet) och kopiera filerna till din webbrot:

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

Repot innehåller en färdig konfiguration i deploy/nginx.conf med säkerhetsrubriker och cachningsregler. Kärnan i en konfiguration för en statisk webbplats är kort:

nginxserver {
    listen 443 ssl;
    server_name markdown.example.com;
    # här placeras raderna ssl_certificate och ssl_certificate_key

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

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

Ladda om nginx med sudo nginx -s reload och öppna domänen.

Alternativ 4: Caddy

Caddy hämtar HTTPS-certifikat automatiskt, vilket gör det till det enklaste alternativet på en VPS:

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

Kopiera först de byggda filerna till /srv; den medföljande Caddyfile levererar dem med samma rubriker som de andra alternativen.

Alternativ 5: Kör lokalt

För personligt bruk behöver du ingen server alls:

bashnpm ci
npm run dev

Öppna den lokala adressen som skrivs ut i din webbläsare.

Håll den uppdaterad

Att uppdatera en statisk webbplats innebär att ersätta dess filer. Ladda ner det nya versionsarkivet, packa upp det över de gamla filerna och ladda om sidan. Eftersom appens filnamn innehåller innehållshashar hämtar webbläsarna den nya versionen utan inaktuella cacheminnen. Bevaka GitHub-repot (Watch → Custom → Releases) för att få besked om nya versioner.

Checklista efter driftsättning

• Webbplatsen öppnas via https:// och http:// omdirigeras dit.
• Dra en Markdown-fil till redigeraren – den öppnas i en ny flik.
• Byt tema och språk i inställningarna.
• Exportera ett testdokument till HTML för att bekräfta att nedladdningar fungerar.

När din redigerare är i drift kan du dela Markdown-fusklappen med teamet och bokmärka våra guider om att förhandsvisa Markdown och exportera till HTML och PDF.