Guia de Sintaxe Markdown: Do Iniciante ao Avançado

Introdução

Markdown é uma linguagem de marcação leve que permite escrever documentos usando um formato de texto simples e fácil de ler e escrever. Esta folha de referência cobre toda a sintaxe Markdown do básico ao avançado, fornecendo exemplos práticos. Seja você um iniciante em Markdown ou alguém que quer consultar sintaxes específicas, este guia pode ajudá-lo.

Sintaxe Básica

Títulos (Headings)

Markdown suporta seis níveis de títulos, usando o símbolo #:

# Título Nível 1
## Título Nível 2
### Título Nível 3
#### Título Nível 4
##### Título Nível 5
###### Título Nível 6

Também pode usar formato de sublinhado (suporta apenas níveis 1 e 2):

Título Nível 1
===============

Título Nível 2
--------------

Parágrafos e Quebras de Linha

Parágrafos precisam ser separados por linhas em branco. Se precisar quebrar linha sem iniciar um novo parágrafo, adicione dois espaços no final da linha.

Este é o primeiro parágrafo.

Este é o segundo parágrafo.

Esta é uma linha  
Esta é a próxima linha (note os dois espaços no final da linha anterior)

Formatação de Texto

Efeito	Sintaxe	Exemplo
Negrito	`texto` ou `__texto__`	texto em negrito
Itálico	`texto` ou `_texto_`	texto em itálico
Negrito e Itálico	`*texto*` ou `___texto___`	*texto negrito e itálico*
Riscado	`~~texto~~`	~~texto riscado~~
Sublinhado	`<u>texto</u>`	texto sublinhado

Listas

Listas Não Ordenadas

Use -, + ou * para criar listas não ordenadas:

- Item um
- Item dois
  - Subitem 2.1
  - Subitem 2.2
- Item três

+ Também pode usar o sinal de mais
* Ou asterisco

Listas Ordenadas

Use números seguidos de ponto para criar listas ordenadas:

1. Primeiro item
2. Segundo item
   1. Subitem 2.1
   2. Subitem 2.2
3. Terceiro item

Listas de Tarefas

Listas de tarefas no estilo GitHub:

- [x] Tarefa completa
- [ ] Tarefa pendente
- [ ] Outra tarefa pendente

Links

Links Inline

[texto do link](https://www.example.com)
[link com título](https://www.example.com "título do link")

Links de Referência

[texto do link][identificador]

[identificador]: https://www.example.com "título opcional"

Links Automáticos

<https://www.example.com>
<[email protected]>

Imagens

![texto alternativo](URL-da-imagem)
![imagem com título](URL-da-imagem "título da imagem")

Imagem por referência:
![texto alternativo][referência-da-imagem]

[referência-da-imagem]: URL-da-imagem "título opcional"

Citações

> Esta é uma citação
> Pode ter múltiplas linhas
> 
> > Também pode aninhar citações

Código

Código Inline

Use `crases` para delimitar código inline

Blocos de Código

Use três crases ou indente com quatro espaços:

```javascript
function hello() {
    console.log("Hello, World!");
}
```

    Ou use indentação (quatro espaços)
    function hello() {
        console.log("Hello, World!");
    }

Linhas Horizontais

Use três ou mais hífens, asteriscos ou underscores:

---
***
___

Sintaxe Avançada

Tabelas

| Coluna1 | Coluna2 | Coluna3 |
|---------|---------|--------|
| Dados1 | Dados2 | Dados3 |
| Dados4 | Dados5 | Dados6 |

Alinhamento:
| Esquerda | Centro | Direita |
|:---------|:------:|--------:|
| Esq | Centro | Dir |

Notas de Rodapé

Este é um exemplo de nota de rodapé[^1].

[^1]: Este é o conteúdo da nota de rodapé.

Listas de Definição

Termo1
: Definição1

Termo2
: Definição2a
: Definição2b

Abreviações

HTML é HyperText Markup Language.

*[HTML]: HyperText Markup Language

GitHub Flavored Markdown (GFM)

Destaque de Sintaxe

Especifique a linguagem no bloco de código:

```python
def hello():
    print("Hello, World!")
```

```json
{
  "name": "example",
  "version": "1.1.0"
}
```

Emojis

:smile: :heart: :thumbsup: :star:

Menções de Usuário e Referências de Issues

@nomedousuario
#123 (número da issue)
organizacao/repositorio#123

Suporte HTML

Markdown suporta HTML inline:

<div style="color: red;">
  Este é texto vermelho
</div>

<details>
  <summary>Clique para expandir</summary>
  Conteúdo oculto
</details>

Caracteres de Escape

Use barra invertida para escapar caracteres especiais:

\* não é itálico
\# não é título
\[não é link\]

Caracteres que precisam de escape:

\ ` * _ {} [] () # + - . ! |

Melhores Práticas

1. Manter Consistência

Escolha um estilo de título e use consistentemente
Use * ou - uniformemente para marcadores de lista
Mantenha indentação consistente (geralmente 2 ou 4 espaços)

2. Priorizar Legibilidade

Adicione linhas em branco antes e depois dos títulos
Use linhas em branco para separar parágrafos
Evite linhas muito longas (recomenda-se 80-100 caracteres)

3. Uso Semântico

Use títulos hierarquicamente, não pule níveis
Use marcações apropriadas (como listas, citações, etc.)
Forneça texto descritivo para links e imagens

Erros Comuns

1. Formato de Lista Incorreto

Incorreto:
-item um (falta espaço)
- item dois

Correto:
- item um
- item dois

2. Formato de Link Incorreto

Incorreto:
(texto do link)[URL]

Correto:
[texto do link](URL)

3. Indentação de Bloco de Código

Incorreto:
```
código
```

Correto:
```
código
```

Dicas de Ferramentas

Usando MD-PDF-WORD

MD-PDF-WORD suporta perfeitamente toda essa sintaxe Markdown e pode converter com precisão para formatos PDF e Word:

Preserva toda a formatação
Renderiza tabelas corretamente
Suporta destaque de código
Trata tipografia multilíngue

Atalhos de Teclado (Editores Comuns)

Função	Windows/Linux	Mac
Negrito	Ctrl + B	Cmd + B
Itálico	Ctrl + I	Cmd + I
Link	Ctrl + K	Cmd + K
Código	Ctrl + `	Cmd + `

Recursos de Aprendizado

Especificação Oficial: Documentação Oficial do Markdown
Guia GitHub: Guia Markdown do GitHub
Tutorial Interativo: Tutorial Markdown
Pré-visualização Online: Use a funcionalidade de pré-visualização em tempo real do MD-PDF-WORD

Conclusão

Dominar a sintaxe Markdown permite criar documentos formatados de forma mais eficiente. Do formato básico de texto a tabelas e blocos de código avançados, Markdown oferece sintaxe rica e concisa. Com ferramentas como MD-PDF-WORD, você pode facilmente converter documentos Markdown para formatos PDF ou Word profissionais, atendendo várias necessidades de documentação.

Lembre-se, o conceito central do Markdown é permitir que você se concentre no conteúdo em vez do formato. Escolha a sintaxe que você precisa, mantenha simplicidade e torne seus documentos bonitos e fáceis de manter.

Pratique Markdown Agora

Use o editor online MD-PDF-WORD para praticar essas sintaxes

Abrir Editor Instalar Extensão