Markdown-inndata

Valideringsrapport

Eksempler på Markdown-validering

Gyldig Markdown har riktig mellomrom og lukkede kodegjerder. Eksempler:

Gyldig Markdown

Gyldig

Ugyldig – mangler mellomrom etter overskrift og ulukket kodegjerde

#API trenger mellomrom etter #. Kodeblokken mangler avsluttende ```.

Ugyldig

Lim inn ett av eksemplene i editoren over. Bruk Eksempel for å laste inn mer data.

Hva er en Markdown-validator?

Markdown har syntaksregler. Ulukkede kodegjerder, ødelagte lenker, feilformede tabeller eller ugyldig HTML kan gi gjengivelsesproblemer. En Markdown-validator sjekker dokumentet og rapporterer vanlige feil. CommonMark-spesifikasjonen definerer syntaksen.

Verktøyet parser Markdownen din og lager en valideringsrapport. Det kjører helt i nettleseren din. Ingenting sendes til en server. For formatering bruker du Markdown-formaterer. For linting (stilregler) bruker du Markdown-linter.

Slik bruker du verktøyet

1

Lim inn eller last opp Markdown

Kopier Markdown og lim det inn i editoren til venstre. Du kan også klikke Last opp for å åpne en .md- eller .markdown-fil. Eksempel laster eksempeldata.

2

Se på valideringsrapporten

Høyre panel viser rapporten. Den lister problemer som ulukkede gjerder, ødelagte referanselenker, feilformede tabeller eller tomme overskrifter. Last ned rapporten for å dele den.

3

Rett opp og valider på nytt

Rett feil i inndata og valider på nytt. For formatering bruker du Markdown-formaterer. For konvertering til HTML bruker du Markdown til HTML.

Når Markdown-validering hjelper

Når du publiserer dokumentasjon, README-filer eller innhold til GitHub, GitLab eller statiske sider som Jekyll og Hugo, fanger validering problemer før de ødelegger visningen. GFM-spesifikasjonen definerer tabeller og utvidelser. Ulukkede kodeblokker eller feilformede tabeller kan ødelegge hele sider. Å kjøre Markdownen her gir trygghet før merge eller utrulling.

Innhold fra flere forfattere eller AI-generert Markdown har ofte små feiler. Validering her gir en sjekkliste. For stilkonsistens (overskriftsnivåer, lister) bruker du Markdown-linter.

Ofte stilte spørsmål

Hva sjekker Markdown-validering?

Den sjekker vanlige problemer som hoppede over overskriftsnivåer (f.eks. hopp fra H1 til H3), ulukkede kodeblokker, feilformatert lenke-syntaks, inkonsekvent listeinnrykk og tomme overskriftsmarkører. Dette er de hyppigste årsakene til feil visning.

Betyr gyldig Markdown at det vises riktig overalt?

Ikke nødvendigvis. Ulike Markdown-renderere håndterer syntaks på forskjellige måter. Validering er basert på CommonMark-spesifikasjonen. GitHub, GitLab og andre verktøy legger til egne utvidelser. Test dokumentet der det skal publiseres for full sikkerhet.

Kan jeg validere en README-fil?

Ja — lim inn innholdet i README.md-filen i editoren og klikk Valider. Dette er en fin måte å oppdage formateringsfeil før du pusher til GitHub eller GitLab.

Er det en størrelsesbegrensning for validering?

Nei. Validering skjer helt i nettleseren din, så det er ingen begrensninger på serversiden. Svært store dokumenter kan ta litt lenger tid å behandle, men de fleste README- og dokumentasjonsfiler behandles umiddelbart.

Relaterte verktøy

Les mer: CommonMark, CommonMark-spesifikasjonen, GitHub Flavored Markdown, Markdown Guide, GitHub, W3C HTML, GitLab, Hugo.