Markdown är perfekt att skriva i, men mottagarna av ett dokument förväntar sig ofta en webbsida eller en PDF. Den goda nyheten: det är enkelt att konvertera Markdown, och i de flesta fall behöver du ingen avancerad verktygskedja.
Här nedan hittar du fyra sätt att göra det, från det snabbaste till det mest konfigurerbara, och ett antal tips som får resultatet att se proffsigt ut.
Snabb jämförelse
| Metod | HTML | Installation | Passar bäst för | |
|---|---|---|---|---|
| Export från webbläsarredigerare | ✅ | ✅ (utskrift) | Ingenting | Vardagsdokument, snabb delning |
| VS Code + tillägg | ✅ | ✅ | Redigerare + tillägg | Den som redan skriver i VS Code |
| Pandoc | ✅ | ✅ | Pandoc (+ en PDF-motor) | Böcker, uppsatser, automatiserade flöden |
| Ett skript (markdown-it, marked) | ✅ | — | Node.js | Egna webbplatser och byggsteg |
1. Exportera från en redigerare i webbläsaren
Den snabbaste vägen är en redigerare som exporterar direkt. Öppna eller klistra in ditt dokument i Markdown Preview Editor – i onlineversionen eller din egen kopia – och använd knapparna i sidhuvudet:
- HTML skapar en enda fristående
.html-fil. Stilar, kodfärgning, formler, diagram och bilder som du öppnade tillsammans med dokumentet bäddas in, så filen ser rätt ut på alla datorer och kan bifogas i ett mejl eller laddas upp var som helst som den är. - Skriv ut öppnar webbläsarens utskriftsdialog. Välj Spara som PDF som mål för att få en PDF. Bara det renderade dokumentet skrivs ut – inget verktygsfält, ingen redigerare.
- Spara laddar ner Markdown-källan som en
.md-fil.
Eftersom allt sker i webbläsaren fungerar det också för dokument som du helst inte laddar upp till en konverterare på nätet.
Så får du en snygg PDF från utskriftsdialogen
- Ställ in Marginaler på Standard eller Minsta, beroende på hur mycket text du vill ha per sida.
- Stäng av Sidhuvud och sidfot för att ta bort datum och webbadress från sidkanterna.
- Slå på Bakgrundsgrafik om du vill behålla bakgrunden i kodblock och randningen i tabeller.
- Använd ett ljust tema för utskrift – det sparar bläck och är lättare att läsa på papper.
2. VS Code med ett tillägg
VS Code har en inbyggd Markdown-förhandsvisning men ingen exportknapp. Tillägg som Markdown PDF eller Markdown Preview Enhanced lägger till kommandon för att exportera HTML och PDF. Det är smidigt om VS Code redan är din redigerare; utseendet på resultatet beror på tillägget, och vissa av dem laddar ner en huvudlös webbläsare första gången de används.
3. Pandoc – den universella konverteraren
Pandoc konverterar mellan dussintals format och är standardverktyget för böcker, akademiska uppsatser och automatiserad dokumentation. När det är installerat räcker ett enda kommando:
bash# Markdown till en komplett HTML-sida
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown till PDF (kräver en PDF-motor, t.ex. en LaTeX-distribution)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown till Word, om någon insisterar
pandoc report.md -o report.docx
Utan --standalone ger Pandoc bara ett HTML-fragment – praktiskt om du ska infoga det i en befintlig sida. PDF-export kräver en separat motor: en LaTeX-distribution eller en HTML-baserad motor som WeasyPrint. Pandocs styrka är kontrollen: mallar, källhänvisningar, numrerade avsnitt och korsreferenser.
4. Några rader JavaScript
Om Markdown ingår i din egen webbplats eller byggprocess är ett bibliotek det mest flexibla alternativet. Med markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Med plugin får du fotnoter, uppgiftslistor, formler med mera. Kom ihåg att resultatet bara är så säkert som indata: om Markdown-texten kommer från andra ska du sanera HTML-koden (till exempel med DOMPurify) innan du publicerar den.
Tips för bättre HTML och PDF
Börja med en tydlig rubrik
Konverterare hämtar dokumentets titel från filnamnet, den första rubriken eller uttryckliga metadata. Ge varje dokument ett beskrivande filnamn och en enda #-rubrik, så blir den exporterade HTML-filen och PDF:en lätta att känna igen i mappen för hämtade filer eller i en webbläsarflik.
Håll bilderna bredvid dokumentet
Använd relativa sökvägar som images/chart.png och lägg filerna i samma mapp. När du öppnar hela mappen i Markdown Preview Editor hittas bilderna och bäddas in i HTML-exporten. Externa bilder som inte laddas i förhandsvisningen bäddas inte heller in.
Styr sidbrytningarna
Markdown saknar syntax för sidbrytning. För utskrivna dokument kan du börja stora avsnitt med en ##-rubrik och hålla tabellerna korta – webbläsare undviker att dela tabellrader, men en enorm tabell fortsätter ändå på nästa sida. I verktyg som tillåter rå HTML och inbäddade stilar, som Pandoc, kan du infoga <div style="page-break-after: always"></div>.
Kontrollera formler och diagram före export
I de flesta verktyg renderas formler och diagram av JavaScript-bibliotek. Kontrollera dem först i förhandsvisningen – se våra guider om matematiska formler i Markdown och Mermaid-diagram. I HTML-exporten från Markdown Preview Editor sparas de som färdig kod och färdiga bilder, så den exporterade filen behöver inga skript.
Välj tema medvetet
Mörka HTML-exporter är behagliga på skärmen men ett dåligt val för papper. Exportera för det medium som läsaren kommer att använda.
Vanliga frågor
Hur konverterar jag Markdown till PDF gratis?
Öppna dokumentet i ett förhandsvisningsverktyg för Markdown som Markdown Preview Editor, klicka på Skriv ut och välj Spara som PDF i utskriftsdialogen. För automatiserad export eller bokliknande resultat kan du använda det kostnadsfria kommandoradsverktyget Pandoc.
Hur konverterar jag Markdown till HTML utan att installera något?
Använd en redigerare i webbläsaren med HTML-export. Markdown Preview Editor skapar en fristående HTML-fil med stilarna inkluderade, direkt i din webbläsare.
Kommer bilderna med i den exporterade HTML-filen?
Lokala bilder som du öppnade tillsammans med dokumentet bäddas in i HTML-filen, så att den fungerar på egen hand. Bilder som ligger kvar på externa servrar bäddas inte in.
Kan jag konvertera Markdown till Word (DOCX)?
Ja, med Pandoc: pandoc input.md -o output.docx. Du kan också exportera HTML och öppna filen i Word, som behåller det mesta av formateringen.