Markdown-utkast

Live-forhåndsvisning

Hva er Markdown-forhåndsvisning?

Markdown-forhåndsvisning er et sanntidsrenderingsverktøy som viser deg nøyaktig hvordan Markdown-kildekoden din vil se ut når den konverteres til HTML. Med et delt panelgrensesnitt skriver du rå Markdown på venstre side mens høyre side viser den renderte utdataen umiddelbart. Denne umiddelbare visuelle tilbakemeldingen eliminerer gjetting om formatering — du kan se hvordan overskrifter ser ut, om lenker fungerer, hvordan kodeblokker renderes, og om tabellsyntaksen er korrekt.

CommonMark er standard Markdown-spesifikasjonen som de fleste forhåndsvisningsverktøy følger, og sikrer konsistent rendering på tvers av plattformer. Dette verktøyet implementerer CommonMark-kompatibel parsing. For GitHub-spesifikke funksjoner som oppgavelister, gjennomstreking og autolenker inkluderer forhåndsvisningen også støtte for GitHub Flavored Markdown-utvidelser.

Forhåndsvisningsverktøy er uvurderlige for alle innholdsskapere som jobber med Markdown. Tekniske skribenter kan validere komplekse nestede lister og kodeblokk-formatering. Open source-vedlikeholdere kan sikre at funksjonstabeller renderes korrekt. Utviklere kan formatere commit-meldinger, pull request-beskrivelser og issue-kommentarer riktig før innsending.

Slik bruker du Markdown-forhåndsvisningen

Følg disse trinnene for å forhåndsvise Markdown som HTML i sanntid. Hvert trinn bruker de faktiske knappene og panelene på denne siden.

Lim inn, last opp eller last inn eksempel

Skriv eller lim inn Markdown i det venstre panelet Markdown-utkast, eller klikk på Last opp for å laste inn en .md-fil. Klikk på Eksempel for å se eksempel-API-dokumentasjon. Støtter CommonMark og GFM (tabeller, oppgavelister, kodeblokker).

Vis live-forhåndsvisning

Det høyre panelet Live-forhåndsvisning oppdateres mens du skriver. Se renderte overskrifter, lister, tabeller og kodeblokker. Ingen forsinkelse — umiddelbar tilbakemelding.

Kopier eller last ned HTML

Klikk på Kopier HTML eller Last ned HTML for å bruke utdataen. Bruk Tøm for å starte på nytt. All behandling kjører i nettleseren din.

Når du faktisk ville brukt dette

Skriving og redigering av dokumentasjon

GitHub-repositorier, ReadTheDocs-prosjekter og dokumentasjonssider bygget med MkDocs eller Hugo bruker alle Markdown. Forhåndsvisningsverktøy lar deg utarbeide og forfine dokumentasjon uten å vente på bygg eller deploys.

Utkast til blogginnlegg og artikler

Bloggplattformer som Jekyll, Hugo, 11ty og Ghost aksepterer Markdown for innhold. Skriv og formater innlegget ditt i forhåndsvisningsverktøyet, kontroller typografi og utheving, og kopier deretter til bloggplattformen din.

Skrive GitHub Issues og PR-er

Når du skriver detaljerte issues eller pull request-beskrivelser på GitHub, lar forhåndsvisningsverktøy deg formatere meldingen din perfekt. Kontroller at tabeller og kodeblokker er korrekte før innsending.

Lage utgivelsesnotater og changelogs

Programvareutgivelser krever klare, velformaterte notater. Bruk Markdown-forhåndsvisning for å utarbeide changelogs med korrekt formatering, versjonsoverskrifter, funksjonslister og advarsler om breaking changes.

Vanlige spørsmål (FAQ)

Viser forhåndsvisningen nøyaktig hvordan innholdet mitt vil renderes overalt?

Forhåndsvisningen bruker CommonMark-kompatibel parsing pluss GitHub Flavored Markdown-utvidelser, som korrekt representerer hvordan innholdet vil se ut på de fleste moderne plattformer. Noen plattformer har imidlertid egendefinerte CSS-stiler eller ytterligere utvidelser. Sjekk målplattformens dokumentasjon hvis du trenger nøyaktig visuell matchning.

Hvilke Markdown-utvidelser støttes?

Denne forhåndsvisningen støtter CommonMark-kjernesyntaks pluss GitHub Flavored Markdown-utvidelser: tabeller, oppgavelister, gjennomstreking (~~tekst~~), autolenker og omtalesyntaks.

Kan jeg kopiere den genererte HTML-en?

Ja. Klikk på "Kopier HTML" for å kopiere den renderte HTML-utdataen til utklippstavlen. Du kan deretter lime den inn i en HTML-redigerer, e-postklient eller webskjema som aksepterer HTML.

Er spesialtegn korrekt escapede i utdataen?

Ja. Parseren escaper automatisk spesielle HTML-tegn (&, <, >, ", ') i tekstinnhold, noe som forhindrer injeksjonsangrep og renderingsfeil.

Hvordan håndterer verktøyet linjeskift?

Verktøyet følger CommonMark-reglene: et enkelt linjeskift i kilden blir et mellomrom i utdataen. For å opprette et ekte linjeskift (<br>), bruk to mellomrom på slutten av linjen etterfulgt av et nytt linje, eller bruk en omvendt skråstrek før det nye linjet.

Kan jeg inkludere rå HTML i Markdownen min?

Ja. Markdown tillater rå HTML-blokker og inline-HTML. Hvis du skriver HTML direkte i Markdownen din, inkluderes det uendret i utdataen. Dette er nyttig for funksjoner som Markdown ikke støtter innebygd.

Markdown-forhåndsvisning