Hva er Markdown-forhåndsviser?
Markdown er den lettvekts-formateringssyntaksen bak README-er, blogginnlegg, chat-meldinger, dokumentasjon og utallige andre steder hvor du ønsker enkel, lesbar formatering uten å skrive rå HTML. Fordi Markdown er ren tekst, er det enkelt å skrive hvor som helst — men det er også lett å få syntaksen litt feil uten å legge merke til det før du allerede har publisert det.
Denne forhåndsviseren gjengir Markdown-en din mens du skriver, side om side med kilden, slik at du kan fange opp formateringsfeil umiddelbart — et manglende mellomrom etter en #, en ulukket kodeblokk-markør, eller en liste som ikke ble skilt fra avsnittet over — før du committer en README, publiserer et innlegg, eller sender en formatert melding.
Når du bør bruke denne kalkulatoren
- Når du skriver en GitHub- eller GitLab-README og vil verifisere formateringen før du committer
- Når du utarbeider et Markdown-innlegg for en bloggplattform, dokumentasjonsside eller wiki
- Når du sjekker at en Markdown-e-post eller chat-melding gjengis riktig før du sender den
- Når du lærer Markdown-syntaks ved å eksperimentere med ulik formatering og se umiddelbare resultater
- Når du konverterer et kort Markdown-utdrag til HTML for innliming i et CMS eller en e-postmal
- Når du feilsøker et Markdown-dokument der noe av formateringen ikke gjengis som forventet
Trinn:
- Skriv eller lim inn Markdown-en din i venstre panel.
- Se den gjengitte HTML-forhåndsvisningen oppdateres umiddelbart til høyre.
- Juster syntaksen din til forhåndsvisningen samsvarer med det du hadde tenkt.
- Kopier den ferdige Markdown-kilden din når du er fornøyd med resultatet.
Formel
# Overskrift →
Overskrift
**fet** → fet *kursiv* → kursiv `kode` →kode
[tekst](url) → tekst
- element → - element
Bruksområder
- Forhåndsvise en GitHub- eller GitLab-README før du committer den
- Utarbeide formaterte meldinger for Slack, Discord, eller andre Markdown-støttende chat-apper
- Sjekke formateringen av blogginnlegg eller dokumentasjon før publisering
- Lære Markdown-syntaks ved å eksperimentere og se umiddelbare resultater
- Raskt konvertere et kort Markdown-utdrag til HTML for innliming andre steder
Nøkkelfordeler
- Se Markdown-en din gjengitt umiddelbart, side om side med kilden
- Fang opp syntaksfeil før du publiserer noe sted
- Kjører helt offline i nettleseren din — ingenting lastes opp
- Gratis, ingen registrering, ingen filstørrelsesgrenser for typisk bruk
Profftips
- Legg til en blank linje før og etter lister og kodeblokker for den mest pålitelige gjengivelsen på tvers av ulike Markdown-tolkere
- Bruk doble stjerner for fet skrift og enkle stjerner (eller understreker) for kursiv for å unngå tvetydighet
- Forhåndsvis i dette verktøyet først, sjekk deretter målplattformen (GitHub, Slack osv.) siden noen støtter ekstra syntaks som tabeller
- Hold overskrifter sekvensielle (ikke hopp fra # til ###) for bedre dokumentstruktur og tilgjengelighet
Vanlige feil å unngå
- Å glemme den blanke linjen som trengs mellom et avsnitt og en påfølgende liste
- Å mangle mellomrommet etter #-symboler i overskrifter, som hindrer dem i å gjengis
- Å la en kodeblokk-markør (```) stå ulukket, som sluker resten av dokumentet som kode
- Å bruke enkle stjerner for fet skrift i stedet for doble stjerner, som gir kursiv i stedet
Nøkkelbegreper forklart
- CommonMark: En standardisert spesifikasjon av Markdown-syntaks, designet for å redusere inkonsistenser
- GFM: GitHub-Flavored Markdown, en utvidet dialekt som støtter tabeller og oppgavelister
- Kodeblokk-markør: En blokk avgrenset av tre bakoverapostrofer (```) brukt til å formatere kode over flere linjer
- Inline-formatering: Formatering brukt innenfor en enkelt linje, som *kursiv* eller `kode`, i motsetning til blokknivå-elementer
Relaterte konsepter
- JSON-formatterer:
- Regex-tester:
- Passord Generator:
- Fargekonverter:
- URL-koder/-dekoder:
Eksempel
Å skrive "## Hei\n\nDette er **fet** og dette er *kursiv*." gjengis som en nivå 2-overskrift etterfulgt av et avsnitt med fet og kursiv tekst.
Tolke resultatene dine
Venstre panel viser den rå Markdown-kildeteksten din, og høyre panel gjengir den som formatert HTML i sanntid. Hvert tastetrykk oppdaterer forhåndsvisningen umiddelbart, slik at du kan se effekten av hvert syntakselement med en gang.
Vanlige gjengivelsesproblemer skyldes som regel mellomrom. En blank linje kreves mellom et avsnitt og en påfølgende liste for de fleste visningsverktøy. Overskrifter trenger et mellomrom etter #-symbolene. Kodeblokk-markører (```) må stå på egen linje for å utløse gjengivelse av kodeblokker.
Forhåndsvisningen er en nær tilnærming til hvordan Markdown-en din vil se ut på de fleste plattformer (GitHub, Slack, Discord osv.), men hver plattform har sitt eget visningsverktøy med små variasjoner. Gjør alltid en siste sjekk på målplattformen for alt utover grunnleggende formatering.