2004-ben John Gruber blogger és Aaron Swartz programozó közzétett egy kis Perl szkriptet és egy szintaxis-specifikációt egyszerű premisszával: a nyers szövegnek önmagában olvashatónak kell lennie, címkék nélkül, miközben tisztán konvertálható HTML-lé. Markdown-nak nevezték el — szándékos szójáték a „markup" szóra.
Húsz évvel később a Markdown a szoftverdokumentáció, fejlesztői kommunikáció és jegyzetelő alkalmazások alapértelmezett írásformátuma. Nem azért sikerült, mert a legerősebb formázási nyelv volt, hanem mert a legolvashatóbb.
A filozófia: olvasható forrásszöveg
Gruber tervezési célja: „Egy Markdown-formázott dokumentumot publikálni kellene tudni úgy, ahogy van, nyers szövegként." Ez a megszorítás alakított minden szintaxis-döntést.
Jó tudni Aaron Swartz, a Markdown társalkotója, kulcsfontosságú szerepet játszott az RSS, Creative Commons és Reddit fejlesztésében is.
Miért szeretik a fejlesztők
- Nyers szöveg = verziókezelés-barát. A Git soronként képes összehasonlítani
- Nincs gyártói függőség. Bármilyen szövegszerkesztőben megnyitható
- Könnyűsúlyú. Kilobájtokban mérhető, nem megabájtokban
- Bármivé konvertálható. Pandoc: HTML, PDF, EPUB, LaTeX, Word
Hol él ma a Markdown
| Terület | Platformok |
|---|---|
| Kód-hosting | GitHub, GitLab, Bitbucket |
| Kommunikáció | Slack, Discord, Reddit, Teams |
| Jegyzetelés | Obsidian, Notion, Bear, Typora |
| Dokumentáció | Docusaurus, MkDocs, Read the Docs |
| Blogolás / CMS | Jekyll, Hugo, Astro, Ghost |
A fragmentáció problémája
Gruber eredeti specifikációja szándékosan informális volt. Az egyértelműség hiánya fragmentációhoz vezetett. Válaszok: CommonMark (2014, szigorú specifikáció), GitHub Flavored Markdown (GFM, táblázatok, feladatlisták), MDX (Markdown + React komponensek), R Markdown (adattudomány).
Az alapszintaxis (címsorok, félkövér, dőlt, listák, linkek, képek, kód) mindenhol ugyanúgy működik.
Jó tudni A fragmentáció ellenére Gruber soha nem támogatta a CommonMark-ot. A Markdownt írásformátumnak tekinti, nem programnyelvnek.
Korlátok és alternatívák
A Markdown nem minden feladatra alkalmas. Összetett elrendezésekhez, gazdag stílusokhoz vagy szemantikus gazdagsághoz alternatívák léteznek: AsciiDoc, reStructuredText, LaTeX, gazdag szöveges szerkesztők.
Tovább
A Markdown valós idejű előnézettel való gyakorlásához próbáld ki a Markdown előnézet eszközt. Szintaxis bevezetőért lásd a Írj Markdownban oktatóanyagot. Mindkettő ingyenes.