Sintaxe de ênfase

A ênfase destaca partes do texto e é uma das formatações mais usadas no Markdown. Diferentes níveis ajudam a realçar informação importante.

Sintaxe básica

Itálico

Usa um asterisco * ou sublinhado _ a envolver o texto:

*texto em itálico*
_texto em itálico_

Resultado: texto em itálicotexto em itálico

Negrito

Usa dois asteriscos ** ou dois sublinhados __:

**texto em negrito**
__texto em negrito__

Resultado: texto em negritotexto em negrito

Negrito + itálico

Usa três asteriscos *** ou três sublinhados ___, ou combinação:

***texto em negrito+itálico***
___texto em negrito+itálico___
**_texto em negrito+itálico_**
*__texto em negrito+itálico__*

Resultado: texto em negrito+itálicotexto em negrito+itálicotexto em negrito+itálicotexto em negrito+itálico

Escolha de marcadores

Asterisco vs sublinhado

Marcador	Vantagens	Desvantagens	Uso sugerido
*	Comum, compatível	Pode confundir com listas	Padrão
_	Confiável em palavras	Menos comum	Casos específicos

Recomendações

✅ Recomenda‑se: consistência
Aqui há **negrito** e *itálico*.

❌ Evitar: mistura
Aqui há **negrito** e _itálico_.

Ênfase dentro de palavras

Limitações do asterisco

Dentro de palavras, * pode não funcionar:

love*is*beautiful  ← pode não renderizar em itálico

Vantagem do sublinhado

_ é mais fiável em palavras:

love_is_beautiful  ← é mais provável que renderize corretamente

Sugestão: para dentro de palavras, prefere _.

Ênfase aninhada

Básico

Podes aninhar itálico em negrito e vice‑versa:

**Isto é negrito, contém *texto em itálico***
*Isto é itálico, contém **texto em negrito***

Resultado: Isto é negrito, contém texto em itálicoIsto é itálico, contém texto em negrito

Casos mais complexos

***Isto é negrito+itálico, com texto normal***
**Parágrafo em negrito, com *cláusula em itálico* e texto normal**
*Parágrafo em itálico, com **palavra‑chave em negrito** e texto normal*

Resultado: Isto é negrito+itálico, com texto normalParágrafo em negrito, com cláusula em itálico e texto normalParágrafo em itálico, com palavra‑chave em negrito e texto normal

Erros comuns e soluções

1) Marcadores não coincidem

❌ Incorreto:
*itálico não fechado
**negrito sem correspondência*

✅ Correto:
*itálico correto*
**negrito correto**

2) Espaços

❌ Incorreto:
* isto não é itálico *
** isto não é negrito **

✅ Correto:
*isto é itálico*
**isto é negrito**

3) Caracteres adjacentes

❌ Pode falhar:
texto*itálico*texto  ← pode não renderizar

✅ Mais seguro:
texto *itálico* texto
texto_italico_texto

Casos especiais

Escape dos marcadores

Para mostrar * ou _, usa barra invertida:

\*isto não é itálico\*
\**isto não é negrito\**
\_isto não é itálico\_

Resultado: *isto não é itálico* *isto não é negrito* _isto não é itálico_

Em código

Em código inline, os marcadores não formatam:

`*o asterisco aqui não é interpretado como itálico*`
`**os dois asteriscos aqui não são interpretados como negrito**`

Resultado: *o asterisco aqui não é interpretado como itálico***os dois asteriscos aqui não são interpretados como negrito**

Uso semântico

Itálico — quando usar

• Ênfase: isto é importante
• Estrangeirismos: Hello World
• Termos: protocolo HTTP
• Obras: conforme Romance dos Três Reinos
• Variáveis: define x = 10

Negrito — quando usar

• Importância: atenção à segurança
• Palavras‑chave: API
• Alertas: não apagues ficheiros críticos
• Subtítulos: Passo 1: instalar

Negrito+itálico — usos

• Crítico: nunca faças isto
• Recomendação: altamente recomendado ler a doc

Boas práticas

1) Usa com moderação

✅ Recomenda‑se: ênfase moderada
Esta funcionalidade **é importante** — lê a documentação.

❌ Evitar: excesso de marcadores
**Esta funcionalidade*****é importante***, **lê****a documentação**.

2) Consistência

✅ Recomenda‑se: usar `*`
Usa **negrito** e *itálico* para ênfase.

❌ Evitar: misturar marcadores
Usar **negrito** e _itálico_.

3) Semântica

✅ Recomenda‑se: ênfase com significado
A função retorna **true** para sucesso, **false** para falha.

❌ Evitar: ênfase decorativa
A função **retorna** true **para** sucesso, **retorna** false **para** falha.

Saída HTML

Conversão para HTML:

*itálico*     → <em>itálico</em>
**negrito**   → <strong>negrito</strong>
***negrito+itálico*** → <strong><em>negrito+itálico</em></strong>

Sintaxe estendida

Alguns processadores suportam ênfases extra:

Tachado

~~texto tachado~~

Resultado: texto removido

Sublinhado

<u>texto sublinhado</u>

Resultado: texto sublinhado

Realce

==texto realçado==  (suporte variável)
<mark>texto realçado</mark>  (HTML)

Exemplos práticos

Documentação técnica

**Endpoint**: `/api/users`

**Método**: *GET*

**Parâmetros**:
- *id* (***obrigatório***): ID do utilizador
- *format* (opcional): formato de retorno

**Retorno**: dados do utilizador ou **mensagem de erro**

Guia do utilizador

## Passos de instalação

**Passo 1**: descarregar o instalador

Visita o site oficial e escolhe a versão para o teu SO. *Garante baixar a versão mais recente*.

**Passo 2**: executar o instalador

Abre o ficheiro e segue o assistente. ***Importante***: desativa o antivírus durante a instalação.

**Passo 3**: verificar a instalação

No terminal, corre `app --version` para confirmar.

Sintaxe relacionada

• Ligações
• Código
• Citações
• Tachado

Exercícios

Cria um documento com:

1. Uma apresentação de produto, com negrito nas features
2. Uma explicação técnica, com termos em itálico
3. Um aviso, com negrito+itálico
4. Frases com ênfases combinadas