Markdown-indata

Valideringsrapport

Vad är en Markdown-validerare?

En Markdown-validerare är ett verktyg som kontrollerar om Markdown-filer följer syntaxspecifikationen och renderas utan fel. Till skillnad från en linter som upprätthåller stilpreferenser fokuserar en validerare på korrekthet — säkerställer att Markdown är strukturellt korrekt och visas rätt på alla plattformar. Valideraren identifierar problematiska element som ej avslutade kodblock, felaktigt formaterade länkar, ogiltiga rubriknivåer och tabeljusteringsproblem.

CommonMark-specifikationen ger referensstandarden som används av alla Markdown-validerare. CommonMark är en förenklad, väldefinierad version av Markdown som eliminerar tvetydigheter i det ursprungliga formatet. Den här webbläsarbaserade valideraren kontrollerar omedelbart innehåll mot CommonMark-regler, och identifierar problem innan publicering på plattformar som GitHub, GitLab eller statiska webbplatsgeneratorer.

Genom att validera Markdown frågar du i grunden: "Kommer detta att renderas korrekt överallt?" Valideraren identifierar subtila problem som inte syns förrän förhandsgranskning — ej avslutade kodblock, länksyntaxfel, brutna tabellstrukturer och bildsökvägar som inte laddas.

Hur man använder Markdown-valideraren

Följ dessa steg för att validera Markdown. Varje steg använder de faktiska knapparna och panelerna på den här sidan.

Klistra in, ladda upp eller läs in exempel

Klistra in Markdown i den vänstra panelen Markdown-indata eller klicka på Ladda upp för att läsa in en .md-fil. Klicka på Exempel för att se exempel på API-dokumentation med avsiktliga valideringsproblem. Kontrollerar CommonMark-kompatibilitet.

Granska valideringsrapporten

Den högra panelen Valideringsrapport visar fel och varningar med radnummer. Identifierar ej avslutade kodblock, felaktigt formaterade länkar, ogiltiga rubriker och tabeller.

Kopiera eller ladda ner rapporten

Klicka på Kopiera eller Ladda ner för att använda rapporten. Använd Rensa för att börja om. All bearbetning sker i din webbläsare.

När du verkligen använder det

Kontroll före publicering

Innan du publicerar innehåll på GitHub, GitLab, Notion eller en statisk webbplatsgenerator, kör validering för att fånga renderingsfel. Att identifiera brutna kodblock eller felaktigt formaterade tabeller före publicering förhindrar pinsamma fel i produktionsdokumentationen.

API-dokumentationskvalitet

Validera Markdown som används i API-dokumentation, OpenAPI-specifikationer och SDK-dokumentation. Säkerställ att kodexempel i block renderas korrekt och att parametertabeller är strukturellt korrekta. Verktyg som Swagger förlitar sig på korrekt Markdown.

Blogg- och innehållsmigrering

Vid migrering av blogginnehåll från HTML eller andra format till Markdown, validera att den konverterade Markdown:en är strukturellt korrekt. Identifiera konverteringsartefakter som escape-tecken, brutna länkar och felaktigt formaterade tabeller.

Tillgänglighet och semantisk korrekthet

Säkerställ att Markdown har semantisk struktur med lämpliga rubriknivåer och alternativ text på bilder. Korrekt Markdown-struktur är avgörande för skärmläsare och säkerställer mer tillgänglig utdata när den renderas till HTML.

Vanliga frågor (FAQ)

Vilket Markdown-dialekt stöder den här valideraren?

Den här valideraren följer strikt CommonMark-specifikationen, det mest bärbara och standardiserade Markdown-formatet. GitHub Flavored Markdown (GFM) utökar CommonMark med tabeller, genomstrykningstext och uppgiftslistor.

Vad är skillnaden mellan valideringsfel och varningar?

Fel är strukturella problem som förhindrar korrekt rendering — ej avslutade kodblock, bruten länksyntax, ogiltiga rubriksekvenser. Varningar signalerar problem som kanske inte bryter rendering men indikerar dåliga metoder eller potentiella tillgänglighetsproblem.

Kan jag validera Markdown specifikt för GitHub?

Det här verktyget validerar CommonMark-kompatibilitet. GitHub använder GitHub Flavored Markdown, vilket utökar CommonMark med tabeller, uppgiftslistor och genomstrykning. Innehåll som klarar den här valideraren fungerar på GitHub.

Kontrollerar valideraren stavning eller grammatik?

Nej, valideraren fokuserar enbart på Markdown-syntax och struktur. För stavnings- och grammatikkontroll, använd separata verktyg som Grammarly eller IDE-tillägg.

Skickas valideringsdata till en server?

Nej. All validering utförs helt i din webbläsare med JavaScript. Ditt Markdown-innehåll överförs aldrig någonstans, vilket gör det säkert för proprietär eller konfidentiell dokumentation.

Markdown-validerare