Markdown

Markdown is een lichtgewicht opmaaktaal waarmee je leesbare platte-tekstbestanden kunt schrijven die eenvoudig naar HTML (of andere formaten) geconverteerd kunnen worden. Het is ontworpen om zowel voor mensen makkelijk te lezen als voor machines makkelijk te verwerken te zijn, met eenvoudige notatie voor kopjes, lijsten, links, afbeeldingen en codeblokken. Voor web- en mobiele ontwikkeling wordt Markdown vaak gebruikt voor README-bestanden, documentatie, blogs en content die via statische site generators of headless CMS naar HTML wordt getransformeerd.

Stel: je bouwt een open-source webcomponent en zet een README.md in je repository. In dat bestand beschrijf je de installatie met een codeblok, geef je voorbeelden van gebruik met kopjes en een lijst van props, en voeg je een link toe naar de live demo. Wanneer iemand je repository bekijkt op GitHub, wordt dat Markdown automatisch mooi gerenderd en blijft het raw-bestand makkelijk te bewerken met een simpele teksteditor.