Wat Is Markdown? Een Volledige Uitleg van de Light-weight Markup Language
Snel antwoord
Markdown is een platte-tekst opmaaktaal die simpele symbolen gebruikt: # voor headings, ** voor bold, * voor italic, - voor lijsten, [text](url) voor links. Het is ontworpen om leesbaar als platte tekst te zijn en converteerbaar naar HTML. Gebruik onze gratis Markdown to HTML Converter.
Invoering
Markdown is een lichtgewicht opmaaktaal gemaakt door John Gruber in 2004 die platte-tekst formattering gebruikt om gestructureerde documenten te produceren. Het doel is leesbaarheid —Markdown-brontekst moet eruitzien als wat het representeert, zonder de visuele rommel van HTML-tags. Markdown is de standaard voor README-bestanden op GitHub, documentatiesites, blogposts en notes-apps zoals Obsidian en Notion.
Stap voor stap
-
Leer de basissyntaxis
Koppen: # H1, ## H2, ### H3. Vetgedrukt: **tekst**. Cursief: *tekst*. Lijsten: - artikel of 1. artikel. Links: [tekst](url). Afbeeldingen: . Code: ```blok```. Blokcitaten: > citaat. Horizontale regel: ---.
-
Begrijp de filosofie
Markdown is ontworpen om leesbaar te zijn als platte tekst. De bron moet er ongeveer hetzelfde uitzien als de uiteindelijk weergegeven uitvoer: **vet** ziet eruit als vet, # Kop lijkt op een kop. Dit staat in contrast met HTML, waar <strong>vet</strong> en <h1>Kop</h1> visueel rommelig zijn.
-
Leer de varianten
Originele Markdown (specificatie van Gruber) is minimaal. CommonMark is een gestandaardiseerde, goed gespecificeerde versie. GitHub Flavored Markdown (GFM) voegt tabellen, doorhalingen, takenlijsten en autolinks toe. Met MDX kunt u React-componenten in Markdown insluiten. De meeste tools ondersteunen GFM.
-
Converteer afwaardering naar HTML
Markdown wordt omgezet naar HTML voor webpublicaties. # Hallo wordt <h1>Hallo</h1>, **vet** wordt <strong>vet</strong>. Statische sitegeneratoren (Astro, Hugo, Jekyll) converteren Markdown tijdens het bouwen. Gebruik onze Markdown to HTML Converter voor onmiddellijke conversie.
Voorbeelden
Kop en paragraaf
Invoer: # Titel
Een paragraaf.
Uitvoer: <h1>Title</h1>
<p>A paragraph.</p>
Vet en cursief
Invoer: **vet** en *cursief*
Uitvoer: <strong>bold</strong> and <em>italic</em>
Link en afbeelding
Invoer: [text](https://example.com) and 
Uitvoer: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Veelvoorkomende problemen
- Regeleinden: een enkele nieuwe regel in Markdown creëert geen regeleinde in HTML. Gebruik twee spaties aan het einde van een regel, of twee nieuwe regels voor een alinea-einde.
- Geneste lijsten: inspringing is belangrijk. Gebruik consequent 2 of 4 spaties voor geneste items; het mixen ervan kan de lijststructuur doorbreken.
- Raw HTML —de meeste Markdown-parsers passeren raw HTML, maar sommige zuiveren het. Controleer het gedrag van uw parser als u HTML rechtstreeks insluit.
- Verschillende smaken: Original Markdown, CommonMark en GFM hebben subtiele verschillen. Controleer welke smaak uw doelplatform ondersteunt.
Tips
- Gebruik Markdown voor schrijven en documentatie: het is veel gemakkelijker te lezen en te schrijven dan HTML.
- GitHub Flavored Markdown (GFM) is de meest voorkomende variant: het voegt tabellen, doorhalingen en takenlijsten toe.
- Schrijf in Markdown en converteer naar HTML tijdens de bouwtijd voor blogs en documentatiesites.
- Gebruik onze Markdown to HTML Converter om Markdown direct in uw browser weer te geven.