La guia ràpida de Markdown més completa en línia

La guia ràpida de Markdown més completa en línia. Cada element de sintaxi amb exemples, sortida renderitzada, compatibilitat entre plataformes, errors habituals i consells d'expert. Posa-la als preferits.

Benjamin McBrayer // Publicat: 21 d’abril del 202618 min de lectura

També en

English Deutsch Español Français Italiano Português

Markdown és una manera senzilla de donar format a text utilitzant símbols com ara coixinets, asteriscs i claudàtors. És útil per a escriptors, blocaires, desenvolupadors, estudiants i qualsevol persona que creï contingut en línia, perquè fa que donar format sigui ràpid, net i fàcil de reutilitzar entre plataformes diferents. Aquesta guia ràpida de Markdown t'ensenyarà les regles més habituals perquè puguis escriure i publicar en Markdown a partir d'ara mateix.

Què és Markdown?

Markdown és un llenguatge de marcatge lleuger que et permet utilitzar símbols de text pla per donar format a documents. Quan escrius **negreta** obtens negreta. Quan escrius # Encapçalament es converteix en un encapçalament. Quan utilitzes Markdown, es converteix a HTML. Funciona pràcticament a totes les plataformes i s'ha convertit en el llenguatge per defecte per donar format a milers d'eines, plataformes i llocs web, incloent-hi GitHub, Reddit, Discord, Notion, Slack i Obsidian.

Per què Markdown és important

John Gruber va crear Markdown el 2004 amb l'objectiu de permetre a la gent escriure i donar format a documents utilitzant text pla sense haver de mirar un garbuix d'etiquetes. Avui dia, Markdown s'ha convertit en un llenguatge que utilitzen pràcticament tots els desenvolupadors i creadors, així com redactors de contingut i altres professionals.

Els avantatges de Markdown

Markdown és tan popular perquè resol molts dels problemes que tenien els formats anteriors.

Markdown funciona a tot arreu i sempre ho farà: pots obrir un fitxer .md en qualsevol editor de text i en qualsevol sistema operatiu, i podràs obrir-lo d'aquí a 50 anys.
Pots llegir Markdown sense renderitzar-lo: a diferència de RTF o HTML, Markdown és un format que és llegible en la seva forma original, no només després de renderitzar-lo.
Markdown és ràpid de treballar: els escriptors experimentats poden donar format al text mentre l'escriuen i treballen més de pressa.
Markdown és universal: com s'ha mencionat abans, moltes plataformes utilitzen Markdown de manera nativa.

Avui dia, conèixer Markdown és important per a qualsevol persona que construeixi alguna cosa amb eines d'IA, perquè els LLM generen Markdown per defecte.

Sintaxi bàsica de Markdown

Aquests elements provenen de l'especificació original de John Gruber del 2004. Tots els parsers de Markdown els admeten, amb petites diferències d'implementació indicades a continuació.

Taula de referència ràpida

Element	Sintaxi de Markdown
Encapçalament	`# H1` `## H2` `### H3`
Negreta	`negreta` o `__negreta__`
Cursiva	`cursiva` o `_cursiva_`
Negreta + cursiva	`*negreta cursiva*`
Cita en bloc	`> text citat`
Llista ordenada	`1. Element`
Llista no ordenada	`- Element` o `* Element` o `+ Element`
Codi en línia	`codi`
Bloc de codi	Sagnat de 4 espais, o blocs amb fences
Línia horitzontal	`---` o `***` o `___`
Enllaç	`[text](https://example.com)`
Imatge	`![text alternatiu](image.jpg)`
Salt de línia	Acaba una línia amb dos espais finals
Caràcter d'escapada	`\asterisc literal\`

Encapçalaments de Markdown

Utilitza d'1 a 6 coixinets (#) seguits d'un espai. El nombre de signes correspon al nivell d'encapçalament HTML.

# Encapçalament 1
## Encapçalament 2
### Encapçalament 3
#### Encapçalament 4
##### Encapçalament 5
###### Encapçalament 6

Sintaxi alternativa (estil Setext), només per a H1 i H2:

Encapçalament 1
===============

Encapçalament 2
---------------

Bones pràctiques:

Posa sempre un espai entre # i el text de l'encapçalament. #Encapçalament funciona en alguns parsers, però es trenca en altres.
Utilitza només un H1 per document (normalment el títol de la pàgina).
No saltis nivells d'encapçalament. Ves de H1 → H2 → H3, no de H1 → H3.
Afegeix línies en blanc abans i després dels encapçalaments per a la màxima compatibilitat.

Negreta, cursiva i èmfasi en Markdown

**Això és negreta** i __això també és negreta__
*Això és cursiva* i _això també és cursiva_
***Negreta i cursiva*** combinades

Es renderitza com:

Això és negreta i això també és negreta Això és cursiva i això també és cursiva Negreta i cursiva combinades

Compte: alguns parsers no gestionen els guions baixos al mig d'una paraula. Per a la màxima compatibilitat, utilitza asteriscs per a l'èmfasi al mig d'una paraula: in**creï**ble, no in__creï__ble.

Cites en bloc de Markdown

Comença qualsevol línia amb > per crear una cita en bloc de Markdown.

> Això és una cita en bloc d'una sola línia.

> Això és una cita en bloc
> que ocupa diverses línies.

> Les cites en bloc es poden anidar.
>
> > Així.
>
> I poden contenir **altres elements de Markdown**.

Les cites en bloc de Markdown funcionen molt bé per destacar citacions, callouts i format d'estil resposta en correus electrònics.

Llistes de Markdown

Les llistes no ordenades accepten -, * o + indistintament. Tria un estil i mantén-lo per coherència.

- Primer element
- Segon element
- Tercer element
  - Element anidat (sagnat amb dos o quatre espais)
  - Un altre element anidat
- Quart element

Les llistes ordenades utilitzen números seguits d'un punt:

1. Primer element
2. Segon element
3. Tercer element

Truc útil: els números no han de ser correctes. Markdown els renumera automàticament:

1. Primer
1. Segon
1. Tercer

…es renderitza igual que 1, 2, 3. Això vol dir que pots reordenar els elements sense haver de renumerar-los.

Anidar llistes ordenades i no ordenades de Markdown:

1. Primer pas
2. Segon pas
   - Subpunt
   - Un altre subpunt
3. Tercer pas
   1. Subpas
   2. Un altre subpas

Elements de llista amb diversos paràgrafs: sagna la continuació amb el mateix nombre d'espais (normalment 4, o una tabulació):

1. Primer element

    Aquest paràgraf pertany al primer element.
    Fixa't en la línia en blanc de sobre i el sagnat.

2. Segon element

Enllaços de Markdown

Els enllaços en línia són l'estil més habitual:

[Visita Google](https://www.google.com)
[Amb títol al passar el ratolí](https://www.google.com "Pàgina principal de Google")

Els enllaços d'estil referència de Markdown són útils quan la mateixa URL apareix diverses vegades o quan vols mantenir el text net:

M'encanten [Obsidian][1] i [VS Code][vscode] per a Markdown.

[1]: https://obsidian.md
[vscode]: https://code.visualstudio.com

URLs automàtiques. Envolta una URL nua amb claudàtors angulars:

<https://example.com>
<hello@example.com>

Enllaços relatius. Enllaça a fitxers al mateix repositori o carpeta:

[Llegeix la llicència](./LICENSE.md)
[Fitxer del directori superior](../README.md)

Enllaços d'àncora de Markdown. Salta a un encapçalament dins de la mateixa pàgina. La majoria de parsers generen IDs automàticament a partir del text de l'encapçalament (minúscules, espais convertits en guions):

Salta a [la secció d'instal·lació](#installation).

## Installation

Imatges de Markdown

La sintaxi d'imatges de Markdown és la sintaxi d'enllaços amb una exclamació al davant:

![Text alternatiu descriptiu](/path/to/image.jpg)
![Text alternatiu](/path/to/image.jpg "Títol opcional al passar el ratolí")

Les imatges d'estil referència de Markdown funcionen igual que els enllaços de referència:

![Logotip de l'empresa][logo]

[logo]: /images/logo.png "El nostre logotip"

Convertir una imatge de Markdown en un enllaç:

[![Text alternatiu](image.jpg)](https://example.com)

Mida de les imatges. El Markdown pur no té sintaxi per a això. Utilitza HTML en línia com a alternativa:

<img src="image.jpg" alt="Text alternatiu" width="400">

Nota d'accessibilitat: escriu sempre text alternatiu significatiu. Els lectors de pantalla en depenen, i els motors de cerca el fan servir per entendre el contingut de les imatges. ![](logo.png) és dolent; ![Logotip de l'empresa, cercle blau amb una M blanca](logo.png) és bo.

Codi en Markdown

El codi en línia de Markdown s'envolta amb un sol backtick:

Instal·la-ho amb `npm install markdown-it`.

Blocs de codi de Markdown. Sagna cada línia amb quatre espais (o una tabulació):

    function hello() {
      console.log("Hello, world!");
    }

A la pràctica, gairebé tothom utilitza blocs de codi amb fences (que es tracten a la secció de sintaxi ampliada més avall) perquè admeten ressaltat de sintaxi.

Escapar backticks dins de codi en línia. Utilitza més backticks a l'exterior:

Per mostrar un backtick, fes servir `` `backtick` `` així.

Línies horitzontals de Markdown

Tres o més guions, asteriscs o guions baixos en la seva pròpia línia:

---
***
___

Totes tres es renderitzen igual. Posa línies en blanc abans i després per a la compatibilitat.

Salts de línia en Markdown

Aquesta és una de les funcionalitats més confuses de Markdown. Hi ha tres comportaments diferents:

Salt de paràgraf. Deixa una línia en blanc entre textos:

Aquest és el paràgraf u.

Aquest és el paràgraf dos.

Salt de línia forçat (mateix paràgraf). Acaba una línia amb dos espais finals:

Aquesta línia acaba amb dos espais.␣␣
Aquesta línia és un salt dins del mateix paràgraf.

Alternativa HTML. Utilitza <br> quan els espais finals semblen massa fràgils:

Aquesta línia té un salt HTML.<br>
Aquesta és la línia següent.

Per què els espais finals són polèmics: són invisibles. La majoria d'editors els eliminen quan deses. GitHub Flavored Markdown (GFM) ho resol tractant qualsevol salt de línia individual com un salt de línia dins d'un paràgraf, però el CommonMark estàndard requereix els espais finals.

Caràcters d'escapada en Markdown

Per mostrar un caràcter que Markdown interpretaria com a format, precedeix-lo amb una barra inversa:

\*Això mostra asteriscs literals\*
\# Això mostra un símbol coixinet literal
\[no és un enllaç\]

Caràcters que es poden escapar: \ ` * _ {} [] () # + - . ! |

Sintaxi ampliada de Markdown

Aquests elements no formen part de l'especificació original de Gruber, però els admeten la majoria de processadors de Markdown àmpliament utilitzats, incloent-hi GitHub, GitLab, Reddit, Stack Overflow, Obsidian, Notion i Discord. La compatibilitat varia, així que consulta la matriu de més avall abans de confiar en qualsevol d'aquests.

Taula de referència ràpida

Element	Sintaxi de Markdown
Taula	`\| Capçalera \| Capçalera \|` + `\| --- \| --- \|`
Bloc de codi amb fences	```llenguatge ... ```
Ressaltat de sintaxi	Nom del llenguatge després de la fence d'obertura
Nota al peu	`Aquí va una nota.[^1]` ... `[^1]: Text de la nota.`
ID d'encapçalament	`### El meu encapçalament {#id-personalitzat}`
Llista de definicions	`terme` salt de línia `: definició`
Ratllat	`~~text eliminat~~`
Llista de tasques	`- [x] Fet` `- [ ] Per fer`
Codi curt d'emoji	`:joy:` `:rocket:`
Ressaltat (highlight)	`==destacat==`
Subíndex	`H~2~O`
Superíndex	`E = mc^2^`
URL automàtica	`<https://example.com>`
Alertes de GitHub	`> [!NOTE]` `> [!WARNING]` `> [!TIP]`

Taules de Markdown

Utilitza barres verticals (|) per a les columnes i una fila de guions com a separador de capçalera.

| Nom      | Rol        | Ubicació      |
| -------- | ---------- | ------------- |
| Alice    | Developer  | Berlín        |
| Bob      | Designer   | Mont-real     |
| Carol    | Writer     | Sydney        |

Alineació de columnes. Afegeix dos punts a la fila separadora:

| Alineat a l'esquerra | Centrat      | Alineat a la dreta |
| :------------------- | :----------: | -----------------: |
| pomes                | plàtans      |               $100 |
| cireres              | dàtils       |                $12 |

Consells que la majoria de guies obliden:

No cal alinear les barres al codi font. El renderitzador s'encarrega de l'espaiat.
Les barres externes són opcionals, però afegir-les ajuda a la llegibilitat i als plugins d'editor.
Pots utilitzar Markdown bàsic dins de les cel·les (**negreta**, *cursiva*, `codi`, enllaços).
No pots utilitzar elements de bloc (encapçalaments, cites en bloc, llistes) dins de les cel·les.
Per a contingut multilínia dins d'una cel·la, utilitza <br> en lloc d'un salt de línia.
Per mostrar una barra vertical literal dins d'una cel·la, utilitza l'entitat HTML |.

Blocs de codi amb fences en Markdown

Tres backticks (o virgulets) obren i tanquen un bloc. Afegeix un identificador de llenguatge després de la fence d'obertura per al ressaltat de sintaxi:

```python
def greet(name):
    return f"Hello, {name}!"

print(greet("world"))
```

Identificadors de llenguatge habituals: python, javascript, typescript, bash, shell, sql, json, yaml, html, css, rust, go, java, c, cpp, csharp, php, ruby, swift, kotlin, dart, r, scala, diff.

Mostrar canvis de codi amb diff:

```diff
- const old = "remove this";
+ const new = "add this";
```

Escapar triples backticks. Envolta el bloc amb quatre backticks:

````
Aquest bloc conté ```triples backticks``` a dins.
````

Notes al peu de Markdown

Les notes al peu de Markdown són perfectes per a citacions, comentaris al marge i notes explicatives sense embrutar el text.

Aquí hi ha una afirmació que necessita una font.[^1]

Aquí hi ha una altra afirmació.[^nota-detallada]

[^1]: Aquesta és una nota al peu curta.
[^nota-detallada]: Les notes amb nom es renderitzen igualment com a números,
    però són més fàcils de seguir al codi font. Poden ocupar diverses línies si
    sagnes la continuació.

IDs d'encapçalament en Markdown

Alguns parsers et permeten assignar IDs personalitzats als encapçalaments per a enllaços d'àncora precisos:

### El meu gran encapçalament {#id-personalitzat}

Salta al [meu encapçalament](#id-personalitzat).

GitHub i molts altres generen IDs automàticament a partir del text de l'encapçalament, així que normalment no et caldrà fer servir això.

Llistes de definicions en Markdown

Markdown
: Un llenguatge de marcatge lleuger per donar format a text pla.

HTML
: El llenguatge de marcatge estàndard per a pàgines web.

CSS
: El llenguatge utilitzat per donar estil a documents HTML.

El suport és irregular. Funciona en Pandoc, PHP Markdown Extra i alguns altres, però no en GFM estàndard.

Ratllat en Markdown

Envolta el text amb dos virgulets per ratllar-lo:

~~Aquest text està ratllat.~~

Es renderitza com: ~~Aquest text està ratllat.~~

Funciona a GFM, Reddit, Discord, Slack i la majoria de processadors àmpliament utilitzats. No a CommonMark estàndard.

Llistes de tasques en Markdown

Caselles de selecció interactives, habitualment utilitzades a issues, pull requests i taulers de projecte de GitHub:

- [x] Escriure el primer esborrany
- [x] Editar per a claredat
- [ ] Publicar l'article
- [ ] Promocionar a les xarxes socials
  - [ ] Twitter
  - [ ] LinkedIn
  - [ ] Hacker News

A GitHub, es renderitzen com a caselles clicables que pots marcar i desmarcar directament a la interfície.

Emojis en Markdown

La majoria de plataformes admeten codis curts d'emoji:

Llança-ho :rocket: i celebra-ho :tada::champagne:

També pots enganxar caràcters d'emoji directament. Es renderitzen bé a qualsevol fitxer Markdown perquè són simplement Unicode. 🚀🎉

Ressaltat, subíndex i superíndex en Markdown

Necessito ==destacar== aquesta idea important.
L'aigua és H~2~O.
La famosa equació d'Einstein: E = mc^2^.

El suport és limitat. Funciona en Obsidian, MultiMarkdown i alguns parsers ampliats, però no en GFM.

Enllaços automàtics d'URL en Markdown

Envolta una URL amb claudàtors angulars per crear un enllaç automàtic:

<https://example.com>
<contact@example.com>

En GitHub Flavored Markdown, qualsevol URL nua es converteix automàticament. Ni tan sols et calen els claudàtors.

Matriu de compatibilitat entre plataformes

Utilitza aquesta taula per comprovar quins elements de sintaxi funcionen a les plataformes que utilitzes. "Sí" significa suport complet, "No" significa que no hi ha suport, i "Parcial" significa que la funcionalitat funciona amb limitacions o utilitza una sintaxi no estàndard.

Funcionalitat	GFM	GitLab	Reddit	Discord	Slack	Notion	Obsidian	Stack Overflow
Encapçalaments	Sí	Sí	Sí	No	No	Sí	Sí	Sí
Negreta / Cursiva	Sí	Sí	Sí	Sí	Parcial*	Sí	Sí	Sí
Ratllat	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Cita en bloc	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Llistes	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Codi en línia	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Codi amb fences	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Ressaltat sintaxi	Sí	Sí	Parcial	Parcial	No	Sí	Sí	Sí
Enllaços	Sí	Sí	Sí	Sí	Parcial**	Sí	Sí	Sí
Imatges	Sí	Sí	Parcial	Parcial	Parcial	Sí	Sí	Sí
Taules	Sí	Sí	Sí	No	No	Sí	Sí	Sí
Llistes de tasques	Sí	Sí	No	No	No	Sí	Sí	No
Notes al peu	Sí	Sí	No	No	No	No	Sí	No
Codis curts d'emoji	Sí	Sí	No	Sí	Sí	No	Parcial	No
Matemàtiques (LaTeX)	Sí	Sí	No	No	No	Sí	Sí	Sí
Diagrames Mermaid	Sí	Sí	No	No	No	No	Sí	No
Subratllat	No	No	No	Sí	No	Sí	Parcial	No
Text de spoiler	No	No	Sí	Sí	No	No	No	No

* Slack utilitza asteriscs simples per a la negreta (no dobles) i guions baixos simples per a la cursiva. ** Slack utilitza la sintaxi <url|text> en lloc dels enllaços de Markdown estàndard.

GitHub Flavored Markdown

GitHub Flavored Markdown (GFM) és el dialecte de Markdown més influent. Com que GitHub és la llar per defecte dels projectes de codi obert, les convencions de GFM s'han convertit en l'estàndard de facto.

GFM afegeix les funcionalitats següents per damunt del Markdown estàndard:

Alertes de GitHub

Una sintaxi especial de cita en bloc per a callouts. S'admeten cinc tipus:

> [!NOTE]
> Informació útil que els usuaris haurien de saber.

> [!TIP]
> Consells útils per fer les coses millor.

> [!IMPORTANT]
> Informació clau que els usuaris necessiten saber.

> [!WARNING]
> Informació urgent que requereix atenció immediata.

> [!CAUTION]
> Adverteix sobre riscos o conseqüències negatives.

Cadascuna es renderitza amb un color i una icona diferents a GitHub.

Referències amb enllaços automàtics en Markdown

Dins dels repositoris de GitHub, certs patrons es converteixen automàticament en enllaços:

#123 → enllaça a l'issue o pull request #123
@username → menciona un usuari
org/repo#123 → enllaça a un issue d'un altre repositori
a1b2c3d → enllaça a un hash de commit

Diagrames Mermaid en Markdown

Els blocs de codi amb fences que tenen mermaid com a llenguatge es renderitzen com a diagrames de flux, diagrames de seqüència i molt més:

```mermaid
graph LR
    A[Inici] --> B{Decisió}
    B -->|Sí| C[Fes-ho]
    B -->|No| D[Salta-ho]
```

Expressions matemàtiques en Markdown

GFM admet matemàtiques LaTeX en dues formes:

Matemàtiques en línia: $E = mc^2$

Matemàtiques en bloc:

$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$

Markdown específic de cada plataforma

Markdown de Discord

Discord utilitza la seva pròpia variant de Markdown. Diferències clau respecte de l'estàndard:

__subratllat__ (guions baixos dobles) produeix subratllat, no negreta
**negreta** continua funcionant
*cursiva* i _cursiva_ funcionen totes dues
||spoiler|| amaga text fins que es clica
# Encapçalament funciona, però només s'admeten H1, H2 i H3
Els blocs de codi i el codi en línia funcionen amb normalitat
No hi ha taules ni imatges via sintaxi de Markdown

Markdown de Slack (mrkdwn)

La variant de Markdown de Slack, confusament anomenada "mrkdwn", divergeix significativament:

*negreta* utilitza asteriscs simples (no dobles)
_cursiva_ utilitza guions baixos simples
~ratllat~ utilitza virgulets simples
`codi` funciona amb normalitat
> cita funciona amb normalitat
Els enllaços utilitzen la sintaxi <https://example.com|text de l'enllaç>
No hi ha encapçalaments, taules ni llistes de tasques

Si enganxes Markdown estàndard a Slack, no es formatarà correctament. Cal convertir-lo abans.

Markdown de Reddit

Reddit admet la majoria de la sintaxi estàndard i ampliada amb alguns matisos:

>!spoiler!< per a text de spoiler
^superíndex amb un accent circumflex (no cal accent de tancament per a paraules soltes)
Admet taules, ratllat i blocs de codi
No admet llistes de tasques, notes al peu ni IDs d'encapçalament personalitzats

Markdown de Notion

Notion admet l'entrada de Markdown, però la converteix al seu sistema de blocs. Pots escriure Markdown per crear blocs ràpidament:

El Markdown estàndard funciona durant l'escriptura
Notion afegeix les seves pròpies funcionalitats (bases de dades, toggles, callouts) que no són Markdown estàndard
Enganxar contingut Markdown generalment s'importa de manera neta

Markdown d'Obsidian

Obsidian és una aplicació per prendre notes que utilitza Markdown, amb diverses extensions:

[[Enllaços d'estil wiki]] per a enllaços interns entre notes
[[Nota#encapçalament]] per enllaçar a un encapçalament concret d'una altra nota
![[Nota]] per incrustar el contingut d'una altra nota
> [!note] Títol del callout per a callouts d'Obsidian (semblants a les alertes de GitHub)
Suport complet de matemàtiques LaTeX
Suport complet de Mermaid

Errors habituals en Markdown

Fins i tot els escriptors experimentats cometen aquests errors de Markdown. Aquí tens què cal evitar i com.

1. Falten línies en blanc al voltant dels elements de bloc de Markdown

Les llistes, els encapçalaments, els blocs de codi i les cites en bloc normalment necessiten una línia en blanc abans i després. Sense això, alguns parsers els fusionen amb el paràgraf que els envolta.

Incorrecte:

Aquí hi ha un paràgraf.
## Encapçalament
Més text.

Correcte:

Aquí hi ha un paràgraf.

## Encapçalament

Més text.

2. Sagnat de llistes de Markdown inconsistent

Les llistes anidades necessiten un sagnat coherent. Barrejar sagnats de dos i quatre espais, o barrejar tabulacions i espais, produeix resultats impredictibles. Tria un i mantén-lo.

3. Oblidar els espais finals per als salts de línia de Markdown

Si vols un salt de línia dins d'un paràgraf però el text se't junta, probablement has oblidat els dos espais finals. Aquesta és la pregunta més habitual sobre Markdown a Stack Overflow.

4. Els camins relatius d'imatges de Markdown es trenquen després del desplegament

![logotip](images/logo.png) funciona al teu editor, però es trenca quan es desplega a un subdirectori. Utilitza camins absoluts respecte al lloc (/images/logo.png) o URLs totalment qualificades per a la portabilitat.

5. Utilitzar cometes intel·ligents d'estil Word en blocs de codi de Markdown

Quan enganxes codi d'un document que té cometes corbes (" en lloc de "), el codi no funcionarà quan es copiï. Enganxa sempre el codi com a text pla als fitxers Markdown.

6. Barrejar HTML i Markdown dins del mateix bloc

El Markdown dins d'etiquetes HTML de bloc sovint no es renderitza. Això falla:

<div>
**Aquesta negreta no es renderitzarà.**
</div>

Soluciona-ho separant-los amb línies en blanc, o utilitzant només HTML en línia:

<div>

**Aquesta negreta sí es renderitzarà.**

</div>

7. Saltar-se nivells d'encapçalament de Markdown

Anar d'un H1 directament a un H3 redueix el nivell d'accessibilitat i perjudica el SEO. Utilitza els nivells d'encapçalament de manera seqüencial.

8. Utilitzar guions baixos dins de paraules en Markdown

in_creï_ble produeix cursiva en alguns parsers i guions baixos literals en altres. Utilitza asteriscs per a l'èmfasi al mig d'una paraula: in*creï*ble.

Preguntes freqüents sobre Markdown

Per a què s'utilitza Markdown?

Markdown s'utilitza per a documentació (READMEs, documentació d'API, wikis), articles de blog, escriptura tècnica, presa de notes, missatges de xat a plataformes com Discord i Slack, llocs web estàtics, llibres electrònics i qualsevol lloc on un format de text pla sigui útil. La majoria dels grans models de llenguatge generen les respostes en Markdown per defecte.

Markdown és igual a totes les plataformes?

No. La sintaxi bàsica (encapçalaments, èmfasi, llistes, enllaços, codi, cites en bloc) funciona gairebé a tot arreu, però les funcionalitats ampliades com ara taules, notes al peu, llistes de tasques i matemàtiques varien significativament entre plataformes. Consulta la matriu de compatibilitat de més amunt per a més informació.

Quina extensió de fitxer utilitza Markdown?

.md és la més habitual. També pots veure .markdown, .mdown, .mkd o .mkdn. Totes són el mateix format. El tipus MIME és text/markdown, registrat a l'RFC 7763.

Puc utilitzar HTML dins de Markdown?

Sí. Pràcticament tots els processadors de Markdown passen l'HTML cru a la sortida. Així és com la gent afegeix funcionalitats que Markdown no admet de manera nativa, com ara etiquetes <kbd> per a tecles de teclat, <details> per a seccions plegables, <iframe> per a incrustacions i molt més.

Com puc convertir Markdown a PDF, Word o HTML?

A HTML: tots els processadors de Markdown ho fan de manera nativa. Pandoc, markdown-it i marked són biblioteques populars.

A PDF: utilitza Pandoc (pandoc input.md -o output.pdf), la funció d'exportació de Typora, o VS Code amb l'extensió Markdown PDF.

A Word (.docx): Pandoc ho gestiona de manera neta amb pandoc input.md -o output.docx.

Markdown admet equacions matemàtiques?

No a l'especificació original, però molts processadors (GitHub, GitLab, Obsidian, MkDocs, Jupyter, Notion) admeten matemàtiques LaTeX. Utilitza $...$ per a matemàtiques en línia i $$...$$ per a equacions en bloc.

En què es diferencia Markdown de l'HTML?

L'HTML utilitza etiquetes (<p>, <strong>, <a>) que són verboses però precises. Markdown utilitza símbols de puntuació que són ràpids d'escriure i continuen sent llegibles en forma de text pla. Tot fitxer Markdown acaba convertint-se a HTML per mostrar-se. Markdown és un superconjunt d'HTML: sempre pots posar HTML dins d'un fitxer Markdown quan necessitis alguna cosa que Markdown no pot expressar.

Què és CommonMark?

CommonMark és una especificació estandarditzada de Markdown, publicada el 2014 per resoldre ambigüitats de l'especificació original de Gruber. La majoria de processadors implementen CommonMark com a base i, a sobre, hi afegeixen extensions (taules, llistes de tasques, etc.). GitHub Flavored Markdown és CommonMark més les extensions de GitHub.

Markdown és gratuït?

Sí. Markdown no és programari, és una especificació. Tant l'especificació original de Gruber com l'especificació CommonMark estan disponibles gratuïtament. El nom "Markdown" en si no té marca registrada.

Quant es triga a aprendre Markdown?

Els fonaments (encapçalaments, negreta, cursiva, enllaços, llistes) es triga uns cinc minuts. Pots escriure Markdown útil en una hora. Dominar la sintaxi ampliada i les variacions específiques de plataforma triga més, però aquesta guia ràpida cobreix gairebé tot el que mai necessitaràs.

Quina diferència hi ha entre Markdown i el text enriquit?

Els formats de text enriquit (.docx, .rtf) emmagatzemen el format com a dades binàries o XML al costat del text. Markdown emmagatzema el format com a símbols visibles de text pla. El compromís: el text enriquit et dona control píxel a píxel a costa de la portabilitat; Markdown et dona portabilitat i velocitat a costa del control de gra fi.