📄
← Voltar aos guias

Guia de Sintaxe Markdown: Referência Completa com Exemplos

· Tags: markdown-syntax, markdown-guide, markdown-formatting, github-flavored-markdown, markdown-reference

Guia de Sintaxe Markdown

O Markdown é uma linguagem de marcação leve que converte texto simples em HTML formatado. Criado por John Gruber em 2004, tornou-se o formato de escrita padrão para documentação, arquivos README e conteúdo técnico em toda a web.

Títulos

Use símbolos #. Um # para o nível mais alto, até seis para o mais profundo:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Os níveis devem aumentar de um em um — pular de ## para #### pode confundir leitores de tela.

Formatação de Texto

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

Links

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

Imagens

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

O texto alternativo é essencial para acessibilidade e SEO — ele é exibido quando as imagens não carregam.

Listas

Listas não ordenadas usam -, * ou +. Listas ordenadas usam números:

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

Código

Código inline usa crases simples: `printf()`.

Blocos de código usam crases triplas com identificador opcional de linguagem:

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


Linguagens suportadas: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## Blockquotes

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

Comuns para chamadas de atenção, notas e citação de fontes externas.

Regras Horizontais

Três ou mais travessões, asteriscos ou sublinhados em uma linha:

---
***
___

Tabelas

Barras verticais (pipes) e travessões definem as colunas. Dois-pontos controlam o alinhamento:

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

Extensões do GitHub Flavored Markdown

O GitHub Flavored Markdown (GFM) adiciona recursos úteis:

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

O GFM também gera links automaticamente — www.example.com fica clicável sem precisar de < >.

Escape de Caracteres Especiais

Prefixe com \ para exibir caracteres literais do Markdown:

\*This is not italic\*
\# This is not a heading

Caracteres que precisam de escape: \ ` * _ { } [ ] ( ) # + - . ! | ~.

Preview de Markdown Online

Use a ferramenta de preview de Markdown para escrever e pré-visualizar Markdown em tempo real. A pré-visualização ao vivo é atualizada enquanto você digita, mostrando exatamente como títulos, links, imagens, blocos de código e tabelas serão renderizados.

Guia de Sintaxe Markdown: Referência Completa com Exemplos - CoolTool