Vuonna 2004 bloggaaja John Gruber ja ohjelmoija Aaron Swartz julkaisivat pienen Perl-skriptin yksinkertaisella premissillä: pelkän tekstin pitäisi olla luettavissa sellaisenaan mutta silti muunnettavissa siististi HTML:ksi. He kutsuivat sitä Markdowniksi.
Kaksikymmentä vuotta myöhemmin Markdown on oletuskirjoitusmuoto ohjelmistodokumentaatiolle, kehittäjäviestinnälle, muistiinpanosovelluksille ja merkittävälle osalle webin sisältöä.
Filosofia: luettava lähdeteksti
Gruberin suunnittelutavoite oli selkeä: «Markdown-muotoillun asiakirjan pitäisi olla julkaistavissa sellaisenaan pelkkänä tekstinä.»
Hyvä tietää Aaron Swartz, Markdownin yhteisluoja, oli myös keskeisessä roolissa RSS:n, Creative Commonsin ja Redditin kehittämisessä.
Miksi kehittäjät rakastavat sitä
- Pelkkä teksti = versionhallintaystävällinen. Git voi vertailla rivi riviltä.
- Ei toimittajalukkoa. Avautuu missä tahansa tekstieditorissa.
- Kevyt. Kilotavuja, ei megatavuja.
- Muuntuu mihin tahansa. Pandoc muuntaa Markdownin HTML:ksi, PDF:ksi, EPUB:ksi, LaTeX:ksi, Wordiksi.
Missä Markdown elää tänään
| Alue | Alustat |
|---|---|
| Koodihosting | GitHub, GitLab, Bitbucket |
| Viestintä | Slack, Discord, Reddit, Teams |
| Muistiinpanot | Obsidian, Notion, Bear, Typora |
| Dokumentaatio | Docusaurus, MkDocs, Read the Docs |
| Blogit | Jekyll, Hugo, Astro, Ghost |
Pirstaloitumisongelma
Gruberin alkuperäinen spesifikaatio oli tarkoituksella epämuodollinen. Tämä johti pirstaloitumiseen: CommonMark (2014), GitHub Flavored Markdown (GFM), MDX, MultiMarkdown ja R Markdown.
Ydinsyntaksi toimii samoin kaikkialla. Erot ovat laajennuksissa ja reunatapauksissa.
Hyvä tietää Pirstaloitumisesta huolimatta John Gruber ei ole koskaan hyväksynyt CommonMarkia. Hän pitää Markdownia kirjoitusmuotona, ei ohjelmointikielenä.
Rajoitukset ja vaihtoehdot
Markdown ei sovi: monimutkaisiin asetteluihin, rikkaaseen tyylittelyyn tai semanttiseen rikkauteen. Näihin on AsciiDoc, reStructuredText, LaTeX ja rikkaat tekstieditorit.
Lue lisää
Harjoittele Markdownia reaaliaikaisella esikatselulla: Markdown-esikatselu. Käytännöllinen johdanto: Kirjoita Markdownilla. Molemmat ilmaisia.