| Sintaxi basica | Sintaxi estesa | Utilitats |
|---|---|---|
| Els elements Markdown descrits en el document de disseny original. | Característiques avançades que es basen en la sintaxi bàsica de Markdown. | Solucions per a coses no recolzades oficialment per Markdown. |
| Capçaleres | Visió general | Visió general |
| Paràgrafs | Disponibilitat | Subratllat |
| Salts de línia | Taules | Sagnat (Tab) |
| Èmfasi | Blocs de codi tancats | Centrat |
| Bloc de cites | Notes al peu | Color |
| Llistes | ID d’encapçalament | Comentaris |
| Codi | Llistes de definicions | Advertències |
| Línies horitzontals | Ratllat | Mida de la imatge |
| Enllaços | Llistes de tasques | Llegendes de la imatge |
| Imatges | Emoji | Obrir enllaços en nova finestra |
| Caràcters d’escapament | Ressaltar | Símbols |
| HTML | Subíndex | Format de taula |
| Superíndex | Taula de continguts | |
| Enllaç URL automàtic | Vídeos |
Markdown és un llenguatge de marques lleuger que podeu utilitzar per a afegir elements de format als documents de text en text net. Creat per John Gruber el 2004, Markdown és ara una de les llengües de marcatge més populars del món.
Utilitzar Markdown és diferent d’utilitzar un editor WYSIWYG. En una aplicació com Microsoft Word, feu clic als botons per a formatar paraules i frases, i els canvis són visibles immediatament. Markdown no és així. Quan creeu un fitxer formatat amb Markdown, afegiu sintaxi Markdown al text per a indicar quines paraules i frases haurien de ser diferents.
Per exemple, per a indicar una capçalera, afegiu un signe de número abans (p. ex., # Encapçalament u). O per a crear una frase en negreta, afegiu dos asteriscs abans i després (p. ex., aquest text és en negreta). Pot trigar una estona a acostumar-se a veure la sintaxi Markdown en el text, especialment si esteu acostumats a aplicacions WYSIWYG.
Podeu afegir elements de format Markdown a un fitxer de text pla utilitzant una aplicació d’edició de text. O podeu utilitzar una de les moltes aplicacions Markdown per a sistemes operatius macOS, Windows, Linux, iOS i Android. També hi ha diverses aplicacions web dissenyades específicament per escriure a Markdown.
Depenent de l’aplicació que utilitzeu, és possible que no pugueu previsualitzar el document formatat en temps real. Però està bé. Segons Gruber, la sintaxi de Markdown està dissenyada per a ser llegible i poc intrusiva, de manera que el text dels fitxers Markdown es pot llegir encara que no es representi.
L’objectiu principal del disseny de la sintaxi de formatació de Markdown és fer-la el més llegible possible. La idea és que un document formatat amb Markdown sigui publicable tal qual, com a text pla, sense semblar que estigui marcat amb etiquetes o instruccions de formatació.