Guia

Què és Markdown i per a què serveix

Tot el que necessites saber per començar a usar Markdown en el teu dia a dia.

Definició

Markdown és un llenguatge de marcatge lleuger. Permet donar format a text pla — títols, negreta, llistes, enllaços — usant símbols simples com #, * o `. El resultat es pot convertir automàticament a HTML, PDF o altres formats.

"Markdown is intended to be as easy-to-read and easy-to-write as is feasible. Readability, however, is emphasized above all else." — John Gruber, Daring Fireball (2004)

Per a qui és útil

Markdown és útil per a qualsevol persona que escrigui en entorns digitals: desenvolupadors que documenten codi, escriptors que prefereixen centrar-se en el contingut, estudiants que prenen apunts, i equips que col·laboren en wikis o plataformes com Notion, Obsidian o Confluence.

La idea clau subjacent: llegibilitat

A diferència de l'HTML, el Markdown és llegible fins i tot sense renderitzar. Un fitxer amb l'extensió .md obert com a text pla continua sent comprensible. Aquesta és la propietat que el fa tan popular: escrius de manera natural i el format s'aplica sol.

"La millor eina d'escriptura és aquella que no notes que estàs fent servir." — Principi de disseny de Markdown

Markdown vs. HTML

Markdown i HTML no competeixen: es complementen. Markdown és una capa d'abstracció sobre HTML que fa l'escriptura més ràpida i menys propensa a errors. De fet, pots mesclar HTML dins de Markdown quan necessites més control. La majoria de parsers, com marked.js (el que fa servir el nostre conversor), admeten HTML incrustrat.

On s'utilitza Markdown

  • 🐙
    GitHub — README, Issues, Pull Requests, Wikis
  • 📝
    Notion — blocs de text, bases de dades, documentació
  • 🔮
    Obsidian — notes enllaçades, gestió del coneixement
  • 💬
    Discord — format de missatges al xat
  • 🤖
    Reddit — posts i comentaris amb format
  • 📱
    WhatsApp — negreta, cursiva i tatxat
  • 🌐
    Webs estàtiques — Jekyll, Hugo, Astro, Gatsby
  • 📚
    Documentació tècnica — Sphinx, MkDocs, Docusaurus
  • ✍️
    Editors — iA Writer, Typora, Bear, Ulysses
  • 🧠
    IA — ChatGPT, Claude, Gemini responen en Markdown
Xuleta

Xuleta de sintaxi Markdown

Totes les construccions de Markdown ordenades per categoria. Clica "Copia" per usar-les directament al conversor.

Història

L'origen i evolució de Markdown

De l'experiment personal d'un blogger a l'estàndard d'escriptura digital mundial.

2004

John Gruber i Aaron Swartz creen Markdown

El blogger i programador John Gruber va crear Markdown amb la col·laboració d'Aaron Swartz — activista digital i cofundador de Reddit. L'objectiu era simple: un format de text llegible que es pogués convertir fàcilment a HTML per publicar a la web. Gruber el va publicar al seu bloc Daring Fireball el 19 de març de 2004.

"A Markdown-formatted document should be publishable as-is, as plain text, without looking like it's been marked up with tags or formatting instructions." — John Gruber, Markdown Syntax Documentation (2004)
2006–2008

Adopció creixent a la web

Plataformes com Stack Overflow (2008) i generadors de webs estàtiques com Jekyll (2008) adopten Markdown com a format principal. Comença a convertir-se en la llengua franca dels desenvolupadors per a la documentació. Es creen múltiples implementacions en diferents llenguatges de programació: Perl, Python, Ruby, PHP, JavaScript.

2009

GitHub adopta Markdown per als READMEs

La decisió de GitHub d'usar Markdown per als fitxers README.md és el punt d'inflexió que converteix Markdown en l'estàndard de facto de la documentació tècnica. Milions de repositoris comencen a usar Markdown. GitHub afegeix extensions pròpies com les taules i les llistes de tasques.

2012

El problema de l'ambigüitat i CommonMark

La manca d'una especificació formal provoca que les múltiples implementacions de Markdown produeixin resultats inconsistents. Un grup de programadors, entre ells Jeff Atwood (cofundador de Stack Overflow) i John MacFarlane (autor de Pandoc), comencen a treballar en una especificació rigorosa. El projecte s'acabarà anomenant CommonMark.

2014–2016

CommonMark: la spec formal

El setembre de 2014 es publica la primera versió de CommonMark, una especificació formal i sense ambigüitats de Markdown. El 2016 s'estabilitza la versió 0.28. CommonMark inclou més de 600 tests d'especificació i resol totes les ambigüitats de l'especificació original. La spec completa és pública i gratuïta.

"If you're interested in Markdown, then you should know about CommonMark, because that's where the future is." — Jeff Atwood, Coding Horror Blog (2014)
2017

GitHub Flavored Markdown (GFM)

GitHub formalitza les seves extensions de Markdown com a GitHub Flavored Markdown (GFM), basada en CommonMark. Afegeix: taules, llistes de tasques (- [x]), URLs autoenlazades, tatxat (~~text~~) i blocs de codi amb destacat de sintaxi. La spec de GFM és pública i molt usada com a referència.

Avui

Markdown, present a tot arreu

Markdown és avui el format d'escriptura digital més estès del món. L'usen milions de persones a GitHub, Notion, Obsidian, Discord, Reddit, WhatsApp i desenes de plataformes més. Els models d'intel·ligència artificial com Claude o ChatGPT responen en Markdown. Eines com Pandoc el converteixen a gairebé qualsevol format. I webs com la Viquipèdia en català n'expliquen la història.

Recursos

Lectures recomanades

Aprofundeix en Markdown amb aquestes fonts fiables.