Caracteres de escape

Os caracteres de escape permitem mostrar símbolos que o Markdown trataria como formatação. Coloca uma barra invertida \ antes do símbolo para neutralizar o seu efeito.

Conceitos básicos

O que é “escape”

Alguns caracteres têm significado especial (por exemplo * para ênfase). Para exibir o próprio símbolo, aplica escape.

Este é *itálico*.
Este é \*asterisco literal\*.

Resultado:

Este é itálico. Este é *asterisco literal*.

Caracteres que costumam precisar de escape

Lista

Estes símbolos têm significado em Markdown:

Caractere	Descrição	Escape	Uso
\\	barra invertida	\\\\	escape
`	crase	\`	código inline
*	asterisco	\*	ênfase/listas
_	sublinhado	\_	ênfase
{}	chavetas	\{ \}	extensão
[]	colchetes	\[ \]	links/imagens
()	parênteses	\( \)	links/imagens
#	cardinal	\#	títulos
+	mais	\+	listas
-	hífen	\-	listas/separador
.	ponto	\.	listas ordenadas
!	exclamação	\!	imagens

Exemplos comuns

Asterisco e sublinhado

❌ Sem escape:
O ficheiro é file_name_v2.txt
Fórmula 2*3*4 = 24

✅ Com escape:
file\_name\_v2.txt
2\*3\*4 = 24

Resultado:

❌ Sem escape: O ficheiro é file_name_v2.txt Fórmula 234 = 24

✅ Com escape: file_name_v2.txt 2*3*4 = 24

Títulos com #

❌ Sem escape:
# TODO: concluir

✅ Com escape:
\# TODO: concluir

Resultado:

❌ Sem escape:

TODO: concluir

✅ Com escape: # TODO: concluir

Símbolos de lista

❌ Sem escape:
Preço: 100 - 200
Passos: 1. Preparar 2. Executar

✅ Com escape:
Preço: 100 \- 200
Passos: 1\. Preparar 2\. Executar

Resultado:

❌ Sem escape: Preço: 100 - 200 Passos: 1. Preparar 2. Executar

✅ Com escape: Preço: 100 - 200 Passos: 1. Preparar 2. Executar

Sintaxe de link

❌ Sem escape:
Ver doc [aqui](http://example.com)

✅ Com escape (mostrar literal):
Ver doc \[aqui\]\(http://example.com\)

Resultado:

❌ Sem escape: Ver doc aqui

✅ Com escape (mostrar literal): Ver doc [aqui](http://example.com)

Casos especiais

Barra invertida

Para exibir \, usa \\:

Caminho: C:\\Users\\Username\\Documents
Unix: /home/user/documents

Resultado:

Caminho: C:\Users\Username\Documents Unix: /home/user/documents

Crases

Para mostrar crases:

Usa `` \` `` para inline
Usa ``` \`\`\` ``` para bloco

Resultado:

Usa \` para inline Usa \`\`\` para bloco

\ no fim da linha

No fim da linha, \ força quebra:

Primeira linha\
Segunda linha (quebra forçada)

Primeira linha\\
Segunda linha (mostra barra)

Resultado:

Primeira linha
Segunda linha (quebra forçada)

Primeira linha\ Segunda linha (mostra barra)

Escape em código

Código inline

Em inline code, geralmente não precisas de escape:

Código: `let result = 2 * 3 + 1;`
Caminho: `C:\Users\*\Documents`

Resultado:

Código: let result = 2 * 3 + 1; Caminho: C:\Users\*\Documents

Blocos de código

Em blocos, os caracteres mantêm‑se literais:

```javascript
// Estes símbolos não precisam de escape
const pattern = /[.*+?^${}()|[\]\\]/g;
const path = "C:\\Users\\*\\Documents";
```

Resultado:

// Estes símbolos não precisam de escape
const pattern = /[.*+?^${}()|[\]\\]/g;
const path = "C:\\Users\\*\\Documents";

Casos práticos

1) Documentação técnica

## Sintaxe de configuração

Formato:

# comentário key = value [section]

Notas:
- Usa \# para comentários
- Usa \[\] para secções
- Usa \* como wildcard

2) Expressões matemáticas

## Fórmulas

Equação linear: y = a\*x + b
Quadrática: y = a\*x² + b\*x + c
Fracção: 1/2 = 0.5

Nota: usa \* para multiplicação

3) Caminhos

## Sistema de ficheiros

Windows:
- Sistema: C:\\Windows\\System32
- Utilizador: C:\\Users\\{username}
- Programas: C:\\Program Files\\*

Linux:
- Root: /
- Home: /home/{username}
- Wildcard: /var/log/\*.log

4) Significados comuns

## Símbolos

Em programação:
- \* ponteiros ou wildcard
- \_ convenções (ex.: \_private)
- \# comentários ou pré‑processador
- \[\] arrays ou parâmetros opcionais
- \{\} blocos de código ou placeholders

Boas práticas

1) Só quando necessário

✅ Recomenda‑se: apenas onde há ambiguidade
Ficheiro: config.txt
Preço: $10-20

❌ Evitar: escape em excesso
Ficheiro: config\.txt
Preço: \$10\-20

2) Consistência

✅ Recomenda‑se: estilo consistente
user\_id, item\_count, max\_size

❌ Evitar: inconsistências
user_id, item\_count, max_size

3) Preferir código quando apropriado

✅ Recomenda‑se: usar formatação de código
`[section]` e `key=value`

❌ Evitar: muitos escapes
\[section\] e key\=value

Erros comuns

1) Esquecer o escape

❌ Incorreto:
O meu username no GitHub é user_name
A função chama‑se get_data()

✅ Correto:
user\_name
get\_data()

2) Escape em excesso

❌ Incorreto:
Hoje é 12\-25
README\.md

✅ Correto:
Hoje é 12-25  
README.md

3) Contexto incorreto

❌ Incorreto: fazer escape em bloco de código

let path = "C:\Users\Name"; ← não precisas de escape duplo

✅ Correto:

let path = "C:\Users\Name";

Saída HTML

Exemplo de saída HTML:

Isto é \*asterisco\*

Converte para:

<p>Isto é *asterisco*</p>

Editores e ferramentas

Editores com pré‑visualização

• VS Code: Markdown Preview Enhanced
• Typora: pré‑visualização
• Mark Text: WYSIWYG
• Obsidian: renderização em tempo real

Linters/regras úteis

<!-- markdownlint rules -->
MD049: consistência de ênfase
MD050: estilo de ênfase

Sintaxe relacionada

• Ênfase
• Código
• Ligações
• Listas

Exercícios

Mostra corretamente:

1. Caminho: C:\Program Files\*\config.ini
2. Variáveis: user_id, file_name, max_count
3. Matemática: 2*x + 3*y = 15
4. Configuração: [section] e key=value
5. Markdown: **negrito** e *itálico*

Tabela de referência

Escapes comuns

Original	Escape	Descrição
\	\\	barra invertida
*	\*	asterisco
_	\_	sublinhado
#	\#	cardinal
[	\[	colchete esquerdo
]	\]	colchete direito
(	\(	parêntese esquerdo
)	\)	parêntese direito
+	\+	mais
-	\-	hífen
.	\.	ponto
!	\!	exclamação