Markdown é uma linguagem de marcação leve que permite formatar texto simples — títulos, listas, links, ênfase — com símbolos simples e legíveis. É amplamente usada para READMEs, documentação e notas.

Como escrevo um bloco de código em Markdown?

Envolva o código entre três crases (```) em linhas próprias, adicionando opcionalmente um nome de linguagem após a abertura para o realce de sintaxe.

O Markdown funciona igual em todo o lado?

A sintaxe básica é consistente, mas os sabores diferem. O GitHub Flavored Markdown acrescenta tabelas, listas de tarefas e texto rasurado ao Markdown padrão.

GUIA RÁPIDO

Guia Markdown

Tudo o que você precisa para escrever em Markdown: cada elemento de sintaxe é mostrado com o código à esquerda e o resultado à direita.

Títulos

Seis níveis de título, do maior ao menor, usando o caractere #.

Markdown

# Titre 1
## Titre 2
### Titre 3
#### Titre 4
##### Titre 5
###### Titre 6

Resultado

Titre 1

Titre 2

Titre 3

Titre 4

Titre 5

Titre 6

Markdown

Titre 1 (syntaxe alternative)
===

Titre 2 (syntaxe alternative)
---

Resultado

Titre 1 (syntaxe alternative)

Titre 2 (syntaxe alternative)

Parágrafos

Separe os parágrafos com uma linha em branco e force uma quebra de linha quando precisar.

Markdown

Un paragraphe est un bloc de texte.

Une ligne vide sépare deux paragraphes.

Resultado

Un paragraphe est un bloc de texte.

Une ligne vide sépare deux paragraphes.

Markdown

Terminez une ligne par deux espaces␣␣
pour forcer un saut de ligne.

Ou utilisez une barre oblique inverse\
en fin de ligne.

Resultado

Terminez une ligne par deux espaces
pour forcer un saut de ligne.

Ou utilisez une barre oblique inverse
en fin de ligne.

Ênfase

Deixe o texto em negrito, itálico ou tachado.

Markdown

*italique* ou _italique_
**gras** ou __gras__
***gras et italique***
~~barré~~

Resultado

italique ou italique
gras ou gras
gras et italique
~~barré~~

Citações

Cite texto em uma ou mais linhas e aninhe as citações.

Markdown

> Une citation simple.
>
> Sur plusieurs lignes.

Resultado

Une citation simple.
Sur plusieurs lignes.

Markdown

> Citation
>> Citation imbriquée
>>> Encore plus profond

Resultado

Citation
Citation imbriquée
Encore plus profond

Listas

Listas com marcadores, numeradas, aninhadas e de tarefas.

Markdown

- Premier élément
- Deuxième élément
- Troisième élément

* Fonctionne aussi avec *
+ ou avec +

Resultado

Premier élément
Deuxième élément
Troisième élément

Fonctionne aussi avec *
ou avec +

Markdown

1. Premier
2. Deuxième
3. Troisième

Resultado

Premier
Deuxième
Troisième

Markdown

- Élément parent
  - Sous-élément
    - Sous-sous-élément
- Retour au parent

Resultado

Élément parent
- Sous-élément
  - Sous-sous-élément
Retour au parent

Markdown

- [x] Tâche terminée
- [ ] Tâche à faire
- [ ] Autre tâche

Resultado

Tâche terminée
Tâche à faire
Autre tâche

Código

Código em linha, blocos de código e realce de sintaxe por linguagem.

Markdown

Utilisez `code en ligne` dans une phrase.

Resultado

Utilisez code en ligne dans une phrase.

Markdown

```
Bloc de code sans coloration
sur plusieurs lignes
```

Resultado

Bloc de code sans coloration
sur plusieurs lignes

Markdown

```js
function salut(nom) {
  return `Bonjour ${nom}`;
}
```

Resultado

function salut(nom) {
  return `Bonjour ${nom}`;
}

Links

Links simples, com título, automáticos ou por referência.

Markdown

[Texte du lien](https://exemple.com)
[Avec une infobulle](https://exemple.com "Titre au survol")

Resultado

Texte du lien
Avec une infobulle

Markdown

Lien automatique : <https://exemple.com>

Lien de référence : [le texte][1]

[1]: https://exemple.com

Resultado

Lien automatique : https://exemple.com

Lien de référence : le texte

Imagens

Insira imagens com texto alternativo, título ou link clicável.

Markdown

![Texte alternatif](image.png)
![Avec titre](image.png "Titre au survol")

Resultado

Markdown

Une image cliquable :

[![Alt](image.png)](https://exemple.com)

Resultado

Une image cliquable :

Tabelas

Crie tabelas e alinhe as colunas à esquerda, ao centro ou à direita.

Markdown

| Nom   | Rôle      | Score |
| ----- | --------- | ----- |
| Alice | Admin     | 95    |
| Bob   | Éditeur   | 82    |

Resultado

Nom	Rôle	Score
Alice	Admin	95
Bob	Éditeur	82

Markdown

| Gauche | Centré | Droite |
| :----- | :----: | -----: |
| a      |   b    |      c |
| dd     |   ee   |     ff |

Resultado

Gauche	Centré	Droite
a	b	c
dd	ee	ff

Linhas horizontais

Separe seções com uma linha horizontal.

Markdown

Trois tirets, astérisques ou underscores :

---

***

___

Resultado

Trois tirets, astérisques ou underscores :

Escape

Mostre caracteres especiais literalmente em vez de interpretá-los.

Markdown

\*Ceci n'est pas en italique\*
\# Ceci n'est pas un titre
\[Ceci n'est pas un lien\]

Resultado

*Ceci n'est pas en italique*
# Ceci n'est pas un titre
[Ceci n'est pas un lien]

Markdown estendido

Notas de rodapé, emoji e HTML incorporado (conforme o motor).

Markdown

Voici une note de bas de page.[^1]

[^1]: Le contenu de la note.

Resultado

Voici une note de bas de page.¹

Le contenu de la note. ↩

Markdown

Émoji par code : :tada: :rocket: :+1:

Émoji direct : 🎉 🚀 👍

Resultado

Émoji par code : 🎉 🚀 👍

Émoji direct : 🎉 🚀 👍

Markdown

On peut aussi insérer du <mark>HTML</mark>
directement : <kbd>Ctrl</kbd> + <kbd>C</kbd>.

Resultado

On peut aussi insérer du HTML directement : Ctrl + C.

Markdown é um padrão, mas alguns elementos (tabelas, caixas de seleção, notas de rodapé, emoji) dependem do motor de renderização usado.

Sobre este Guia de Markdown

Uma folha de consulta de Markdown clara e cheia de exemplos que abrange a sintaxe do dia a dia: títulos, negrito e itálico, listas, links, imagens, tabelas, blocos de código, citações e mais. Cada exemplo mostra o código Markdown ao lado do resultado renderizado.

FAQ

O que é Markdown?: Markdown é uma linguagem de marcação leve que permite formatar texto simples — títulos, listas, links, ênfase — com símbolos simples e legíveis. É amplamente usada para READMEs, documentação e notas.
Como escrevo um bloco de código em Markdown?: Envolva o código entre três crases (```) em linhas próprias, adicionando opcionalmente um nome de linguagem após a abertura para o realce de sintaxe.
O Markdown funciona igual em todo o lado?: A sintaxe básica é consistente, mas os sabores diferem. O GitHub Flavored Markdown acrescenta tabelas, listas de tarefas e texto rasurado ao Markdown padrão.