menu

Sintaxe Básica

Aprenda os conceitos fundamentais para criar documentos no formato Markdown

Visão geral

Quase todos os aplicativos Markdown suportam a sintaxe básica descrita no documento de design original de John Gruber. Existem pequenas variações e discrepâncias entre os processadores Markdown - essas são anotadas em linha sempre que possível.

Títulos

Para criar um título, adicione uma cerquilha (#) na frente de uma palavra ou frase. O número de sinais numéricos que você usa deve corresponder ao nível do título. Por exemplo, para criar um nível de título três (<h3>), use três sinais numéricos (cerquilhas) (por exemplo, ### Meu título).

Markdown HTML Resultado
# Título de nível 1 <h1>Título de nível 1</h1> Título de nível 1
## Título de nível 2 <h2>Título de nível 2</h2> Título de nível 2
### Título de nível 3 <h3>Título de nível 3</h3> Título de nível 3
#### Título de nível 4 <h4>Título de nível 4</h4> Título de nível 4
##### Título de nível 5 <h5>Título de nível 5</h5> Título de nível 5
###### Título de nível 6 <h6>Título de nível 6</h6> Título de nível 6

Sintaxe alternativa

Como alternativa, na linha abaixo do texto, adicione qualquer número de caracteres == para título de nível 1 ou -- para título de nível 2.

Markdown HTML Resultado
Título de nível 1
===============
<h1>Título de nível 1</h1> Título de nível 1
Título de nível 2
---------------
<h2>Título de nível 2</h2> Título de nível 2

Práticas recomendadas para o uso de títulos em Markdown

Os aplicativos de Markdown não concordam em como lidar com um espaço ausente entre a cerquilha (#) e o título. Para compatibilidade, sempre coloque um espaço entre os sinais numéricos e o título.

  Faça isso   Não faça isso
# Aqui está um título #Aqui está um título

Parágrafos

Para criar parágrafos, use uma linha em branco para separar uma ou mais linhas de texto.

Markdown HTML Resultado
Eu realmente gosto de usar o Markdown.

Acho que vou usá-lo para formatar todos os meus documentos a partir de agora.
<p>Eu realmente gosto de usar o Markdown.</p>

<p>Acho que vou usá-lo para formatar todos os meus documentos a partir de agora.<p>

Eu realmente gosto de usar o Markdown.

Acho que vou usá-lo para formatar todos os meus documentos a partir de agora.

Melhores práticas para usar parágrafos em Markdown

A menos que o parágrafo esteja em uma lista, não recue os parágrafos com espaços ou tabulações.

  Faça isso   Não faça isso
Não coloque tabulações ou espaços na frente dos parágrafos.

Mantenha as linhas alinhadas à esquerda desta maneira.

    Isso pode resultar em problemas inesperados de formatação.

  Não adicione tabulações ou espaços na frente dos parágrafos.

Quebras de linha

Para criar uma quebra de linha (<br>), finalize uma linha com dois ou mais espaços e pressione o Enter.

Markdown HTML Resultado
Esta é a primeira linha.  
E esta é a segunda linha.
<p>Esta é a primeira linha.<br>
E esta é a segunda linha.</p>

Esta é a primeira linha.
E esta é a segunda linha.

Melhores práticas para o uso de quebra de linhas em Markdown

Você pode usar dois ou mais espaços (chamados de "espaço em branco à direita") para quebras de linha em quase todos os aplicativos Markdown, mas isso é controverso. É difícil ver os espaços em branco em um editor e muitas pessoas acidentalmente ou intencionalmente colocam dois espaços após cada frase. Por esse motivo, convém usar algo diferente de espaço em branco à direita para quebras de linha. Felizmente, há outra opção suportada por quase todos os aplicativos Markdown: a tag <br> do HTML.

Para compatibilidade, use espaço em branco à direita ou a tag <br> do HTML no final da linha.

Existem duas outras opções que não recomendo. O CommonMark e algumas outras linguagens de marcação leves permitem digitar uma barra invertida (\) no final da linha, mas nem todos os aplicativos Markdown suportam isso, portanto, não é uma boa opção do ponto de vista de compatibilidade. E pelo menos algumas linguagens de marcação leves não exigem nada no final da linha - basta pressionar o Enter e elas criarão uma quebra de linha.

  Faça isso   Não Faça isso
Primeira linha com dois espaços depois.  
E a próxima linha.

Primeira linha com a tag HTML depois.<br>
E a próxima linha.

Primeira linha com uma barra invertida após.\
E a próxima linha.

Primeira linha sem nada depois.
E a próxima linha.

Ênfase

Você pode dar ênfase, colocando o texto em negrito ou itálico.

Negrito

Para negrito, adicione dois asteriscos ou sublinhados antes e depois de uma palavra ou frase. Para destacar em negrito o meio de uma palavra, adicione dois asteriscos sem espaços ao redor das letras.

Markdown HTML Resultado
Eu adoro **texto em negrito**. Eu adoro <strong>texto em negrito</strong>. Eu adoro texto em negrito.
Eu adoro __texto em negrito__. Eu adoro <strong>texto em negrito</strong>. Eu adoro texto em negrito.
O Amor**é**poderoso O Amor<strong>é</strong>poderoso O Amorépoderoso

Práticas recomendadas para uso do negrito em Markdown

Os aplicativos de Markdown não concordam em como lidar com sublinhados no meio de uma palavra. Para compatibilidade, use asteriscos para destacar em negrito o meio de uma palavra.

  Faça isso   Não Faça isso
amor**é**poderoso amor__é__poderoso

Itálico

Para colocar o texto em itálico, adicione um asterisco ou sublinhado antes e depois de uma palavra ou frase. Para formatar em itálico o meio de uma palavra, adicione um asterisco sem espaços ao redor das letras.

Markdown HTML Resultado
Colocar o texto em itálico é *mamão com açúcar*. Colocar o texto em itálico é <em>mamão com açúcar</em>. Colocar o texto em itálico é mamão com açúcar.
Colocar o texto em itálico é _mamão com açúcar_. Colocar o texto em itálico é <em>mamão com açúcar</em>. Colocar o texto em itálico é mamão com açúcar.
mamão*com*açúcar mamão<em>com</em>açúcar mamãocomaçúcar

Práticas recomendadas para uso do itálico em Markdown

Os aplicativos de Markdown não concordam em como lidar com sublinhados no meio de uma palavra. Para compatibilidade, use asteriscos (*) para enfatizar usando itálico.

  Faça isso   Não Faça isso
mamão*com*açúcar mamão_com_açúcar

Negrito e Itálico

Para enfatizar o texto com negrito e itálico ao mesmo tempo, adicione três asteriscos ou sublinhados antes e depois de uma palavra ou frase. Para negrito e itálico no meio de uma palavra, adicione três asteriscos sem espaços ao redor das letras.

Markdown HTML Resultado
Isso é realmente ***importante***. Isso é realmente <strong><em>importante</em></strong>. Isso é realmente importante.
Isso é realmente ___importante___. Isso é realmente <strong><em>importante</em></strong>. Isso é realmente importante.
Isso é realmente __*importante*__. Isso é realmente <strong><em>importante</em></strong>. Isso é realmente importante.
Isso é realmente **_importante_**. Isso é realmente <strong><em>importante</em></strong>. Isso é realmente importante.
Esse texto é realmente ***muito***importante. Esse texto é realmente <strong><em>muito</em></strong>importante. Esse texto é realmente muitoimportante.

Melhores práticas para uso do negrito e itálico em Markdown

Os aplicativos de Markdown não concordam em como lidar com sublinhados no meio de uma palavra. Para compatibilidade, use asteriscos para negrito e itálico no meio de uma palavra.

  Faça isso   Não Faça isso
Esse texto é realmente ***muito***importante. Esse texto é realmente ___very___importante.

Bloco de citação

Para criar um bloco de citação, adicione um sinal de maior que > na frente de um parágrafo.

> Dorothy a seguiu pelos aposentos de seu castelo.

Assim seria o resultado:

Dorothy a seguiu pelos aposentos de seu castelo.

Bloco de citação com vários parágrafos

Os blocos de citação podem conter vários parágrafos. Adicione um sinal de maior que > nas linhas em branco entre os parágrafos.

> Dorothy a seguiu pelos aposentos de seu castelo.
>
> A Bruxa ordenou que ela limpasse as panelas e chaleiras, varresse o chão e mantivesse o fogo alimentado com lenha.

E assim seria o resultado:

Dorothy a seguiu pelos aposentos de seu castelo.

A Bruxa ordenou que ela limpasse as panelas e chaleiras, varresse o chão e mantivesse o fogo alimentado com lenha.

Blocos de citação aninhados

Os blocos de citação podem ser aninhados. Adicione dois sinais de maior que >> na frente do parágrafo que você deseja aninhar.

> Dorothy a seguiu pelos aposentos de seu castelo.
>
>> A Bruxa ordenou que ela limpasse as panelas e chaleiras, varresse o chão e mantivesse o fogo alimentado com lenha.

O resultado seria esse:

Dorothy a seguiu pelos aposentos de seu castelo.

A Bruxa ordenou que ela limpasse as panelas e chaleiras, varresse o chão e mantivesse o fogo alimentado com lenha.

Bloco de citação com outros elementos

As citações de bloco podem conter outros elementos no formato Markdown. Nem todos os elementos podem ser usados. Você precisará experimentar para ver quais funcionam.

> #### Os resultados trimestrais estão ótimos!
>
> - A receita está acima do esperado.
> - Os lucros foram maiores do que nunca.
>
>  *Tudo* está de acordo com o que foi **planejado**.

O resultado seria esse:

Os resultados trimestrais estão ótimos!

  • A receita está acima do esperado.
  • Os lucros foram maiores do que nunca.

Tudo está de acordo com o que foi planejado.

Listas

Você pode organizar itens em listas ordenadas e não ordenadas.

Listas ordenadas

Para criar uma lista ordenada, comece com um número seguido por um ponto e o conteúdo do elemento. Os números não precisam estar em ordem numérica, mas a lista deve começar com o número um.

Markdown HTML Resultado
1. Primeiro item
2. Segundo item
3. Terceiro item
4. Quarto item
<ol>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item</li>
<li>Quarto item</li>
</ol>
  1. Primeiro item
  2. Segundo item
  3. Terceiro item
  4. Quarto item
1. Primeiro item
1. Segundo item
1. Terceiro item
1. Quarto item
<ol>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item</li>
<li>Quarto item</li>
</ol>
  1. Primeiro item
  2. Segundo item
  3. Terceiro item
  4. Quarto item
1. Primeiro item
8. Segundo item
3. Terceiro item
5. Quarto item
<ol>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item</li>
<li>Quarto item</li>
</ol>
  1. Primeiro item
  2. Segundo item
  3. Terceiro item
  4. Quarto item
1. Primeiro item
2. Segundo item
3. Terceiro item
    1. Item recuado
    2. Item recuado
4. Quarto item
<ol>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item
<ol>
<li>Item recuado</li>
<li>Item recuado</li>
</ol>
</li>
<li>Quarto item</li>
</ol>
  1. Primeiro item
  2. Segundo item
  3. Terceiro item
    1. Item recuado
    2. Item recuado
  4. Quarto item

Listas não ordenadas

Para criar uma lista não ordenada, adicione traços (-), asteriscos (*), ou sinais de adição (+) na frente dos elementos da lista. Recue um ou mais itens para criar uma lista aninhada.

Markdown HTML Resultado
- Primeiro item
- Segundo item
- Terceiro item
- Quarto item
<ul>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item</li>
<li>Quarto item</li>
</ul>
  • Primeiro item
  • Segundo item
  • Terceiro item
  • Quarto item
* Primeiro item
* Segundo item
* Terceiro item
* Quarto item
<ul>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item</li>
<li>Quarto item</li>
</ul>
  • Primeiro item
  • Segundo item
  • Terceiro item
  • Quarto item
+ Primeiro item
* Segundo item
- Terceiro item
+ Quarto item
<ul>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item</li>
<li>Quarto item</li>
</ul>
  • Primeiro item
  • Segundo item
  • Terceiro item
  • Quarto item
- Primeiro item
- Segundo item
- Terceiro item
    - Item recuado
    - Item recuado
- Quarto item
<ul>
<li>Primeiro item</li>
<li>Segundo item</li>
<li>Terceiro item
<ul>
<li>Item recuado</li>
<li>Item recuado</li>
</ul>
</li>
<li>Quarto item</li>
</ul>
  • Primeiro item
  • Segundo item
  • Terceiro item
    • Item recuado
    • Item recuado
  • Quarto item

Adicionando elementos em listas

Para adicionar outro elemento em uma lista e preservar a continuidade da lista, recue o elemento quatro espaços ou uma tabulação, conforme mostrado nos exemplos a seguir.

Parágrafos

* Este é o primeiro item da lista.
* Aqui está o segundo item da lista.

    Preciso adicionar outro parágrafo abaixo do segundo item da lista.

* E aqui está o terceiro item da lista.

O Resultado fica assim:

  • Este é o primeiro item da lista.
  • Aqui está o segundo item da lista.

    Preciso adicionar outro parágrafo abaixo do segundo item da lista.

  • E aqui está o terceiro item da lista.

Bloco de citação

* Este é o primeiro item da lista.
* Aqui está o segundo item da lista.

    > um bloco de citação ficaria ótimo abaixo do segundo item da lista.

* E aqui está o terceiro item da lista.

O resultado ficaria assim:

  • Este é o primeiro item da lista.
  • Aqui está o segundo item da lista.

    um bloco de citação ficaria ótimo abaixo do segundo item da lista.

  • E aqui está o terceiro item da lista.

Blocos de código

Blocos de código normalmente são recuados quatro espaços ou uma tabulação. Quando eles estiverem em uma lista, recue oito espaços ou duas tabulações.

1.  Abra o arquivo
2.  Encontre o seguinte bloco de código na linha 21:

        <html>
        <head>
        <title>Teste</title>
        </head>

3.  Atualize o título para corresponder ao nome do seu site.

O Resultado fica assim:

  1. Abra o arquivo.
  2. Encontre o seguinte bloco de código na linha 21:

    <html>
    <head>
      <title>Teste</title>
    </head>
  3. Atualize o título para corresponder ao nome do seu site.

Imagens

1.  Abra o arquivo que contém o mascote do Linux.
2.  Maravilhe-se com a sua beleza.

![Tux, the Linux mascot](/assets/img/tux.png)

3.  Feche o arquivo.

O Resultado fica assim:

  1. Abra o arquivo que contém o mascote do Linux.
  2. Maravilhe-se com sua beleza.

    Tux, o mascote do Linux
  3. Feche o arquivo.

Código

Para denotar uma palavra ou frase como código, coloque-a entre crases (`).

Markdown HTML Resultado
No prompt de comando, digite `nano`. No prompt de comando, digite <code>nano</code>. No prompt de comando, digite nano.

Escapando crases

Se a palavra ou frase que você deseja denotar como código incluir uma ou mais crases, você poderá escapá-las colocando crases duplas (``).

Markdown HTML Resultado
``Usando `código` no seu Markdown.`` <code>Usando `código` no seu Markdown.</code> Usando `código` no seu Markdown.

Blocos de código

Para criar blocos de código, recue cada linha do bloco em pelo menos quatro espaços ou uma tabulação.

    <html>
    <head>
    </head>
    </html>

O resultado:

<html>
<head>
</head>
</html>

Obs: Para criar blocos de código sem recuar linhas, use blocos de código cercados.

Linhas horizontais

Para criar uma linha horizontal, use três ou mais asteriscos (***), traços (---), ou sublinhados (___) em uma linha contendo apenas esse caracteres.

***

---

_________________

O resultado dos três é idêntico:


Práticas recomendadas para uso de linhas horizontais em Markdown

Para compatibilidade, coloque linhas em branco antes e depois das linhas horizontais.

  Faça isso   Não Faça isso
Tente colocar uma linha em branco antes...

---

...e depois de uma linha horizontal.
Sem linhas em branco, isso seria um título.
---
Não Faça isso!

Para criar um link, coloque o texto do link entre colchetes (exemplo, [Duck Duck Go]) e siga-o imediatamente com a URL entre parênteses (exemplo, (https://duckduckgo.com)).

Meu mecanismo de pesquisa favorito é o [Duck Duck Go](https://duckduckgo.com).

O Resultado fica assim:

Meu mecanismo de pesquisa favorito é o Duck Duck Go.

Opcionalmente, você pode adicionar um título para um link. Isso aparecerá como uma dica de ferramenta quando o usuário passar o mouse sobre o link. Para adicionar um título, coloque-o entre aspas após a URL.

Meu mecanismo de pesquisa favorito é o [Duck Duck Go](https://duckduckgo.com "O melhor mecanismo de pesquisa quando o assunto é privacidade").

O Resultado fica assim:

Meu mecanismo de pesquisa favorito é o Duck Duck Go.

URLs e endereços de email

Para transformar rapidamente uma URL ou endereço de email em um link, coloque-os entre parênteses angulares <> (sinal de "maior que" e "menor que").

<https://markdown.net.br>
<email@exemplo.com.br>

O Resultado fica assim:

https://markdown.net.br
email@exemplo.com.br

Para realçar links, adicione asteriscos antes e depois dos colchetes e parênteses. Para indicar links como código, adicione crases nos parênteses.

Eu apoio o **[EFF](https://eff.org)**.
Esse é o *[Guia Completo do Markdown](https://markdown.net.br)*.
Pule para a seção [`código`](#code).

O Resultado fica assim:

Eu apoio o EFF.
Esse é o Guia Completo do Markdown.
Pule para a seção código.

Os links de estilo de referência são um tipo especial de link que facilita a exibição e a leitura de URLs no Markdown. Os links no estilo de referência são construídos em duas partes: a parte que você mantém alinhada com o texto e a parte que você armazena em outro lugar no arquivo para manter a leitura do texto mais fácil.

A primeira parte de um link no estilo de referência é formatada com dois conjuntos de colchetes. O primeiro conjunto de colchetes envolve o texto que deve aparecer vinculado. O segundo conjunto de colchetes exibe um rótulo usado para apontar para o link que você está armazenando em outro local do documento.

Embora não seja necessário, você pode incluir um espaço entre o primeiro e o segundo conjunto de colchetes. O rótulo no segundo conjunto de colchetes não diferencia maiúsculas de minúsculas e pode incluir letras, números, espaços ou pontuação.

Isso significa que os seguintes exemplos de formato são equivalentes para a primeira parte do link:

  • [casa-do-hobbit][1]
  • [casa-do-hobbit] [1]

A segunda parte de um link de estilo de referência é formatada com os seguintes atributos:

  1. O rótulo, entre colchetes, seguido imediatamente por dois pontos e pelo menos um espaço (por exemplo, [rótulo]: ).
  2. O endereço do link, que você pode opcionalmente colocar entre parênteses angulares <>.
  3. O título opcional para o link, que pode ser colocado entre aspas duplas "", aspas simples '' ou parênteses ().

Os seguintes exemplos de formatos são equivalentes para formatar a segunda parte do link:

  • [1]: https://pt.wikipedia.org/wiki/Hobbit
  • [1]: https://pt.wikipedia.org/wiki/Hobbit "Aprendendo sobre os Hobbits"
  • [1]: https://pt.wikipedia.org/wiki/Hobbit 'Aprendendo sobre os Hobbits'
  • [1]: https://pt.wikipedia.org/wiki/Hobbit (Aprendendo sobre os Hobbits)
  • [1]: <https://pt.wikipedia.org/wiki/Hobbit> "Aprendendo sobre os Hobbits"
  • [1]: <https://pt.wikipedia.org/wiki/Hobbit> 'Aprendendo sobre os Hobbits'
  • [1]: <https://pt.wikipedia.org/wiki/Hobbit> (Aprendendo sobre os Hobbits)

Você pode colocar essa segunda parte do link em qualquer lugar do seu documento Markdown. Algumas pessoas as colocam imediatamente após o parágrafo em que aparecem, enquanto outras as colocam no final do documento (como notas de rodapé).

Juntando todas as peças

Digamos que você adicione um endereço a um parágrafo como um link de URL padrão ficando assim em Markdown:

Em um buraco no chão, vivia um hobbit. Não é um buraco desagradável, sujo e úmido, cheio de vermes e com um cheiro estranho, menos ainda um buraco seco e arenoso, sem nada para sentar ou comer: era uma [casa-de-hobbit](https://pt.wikipedia.org/wiki/Hobbit "Aprendento sobre os Hobbits"), e isso significa conforto.

Embora possa apontar para informações adicionais interessantes, o URL exibido realmente não adiciona muito ao texto bruto existente, além de dificultar a leitura. Para corrigir isso, você pode formatar o URL dessa maneira:

Em um buraco no chão, vivia um hobbit. Não é um buraco desagradável, sujo e úmido, cheio de vermes e com um cheiro estranho, menos ainda um buraco seco e arenoso, sem nada para sentar ou comer: era uma [casa-de-hobbit][1], e isso significa conforto.

[1]: <https://pt.wikipedia.org/wiki/Hobbit> "Aprendento sobre os Hobbits"

Nos dois casos acima, o resultado seria idêntico:

Em um buraco no chão, vivia um hobbit. Não é um buraco desagradável, sujo e úmido, cheio de vermes e com um cheiro estranho, menos ainda um buraco seco e arenoso, sem nada para sentar ou comer: era uma casa-de-hobbit, e isso significa conforto.

e o HTML para o link seria:

<a href="https://pt.wikipedia.org/wiki/Hobbit" title="Aprendento sobre os Hobbits">casa-de-hobbit</a>

Os aplicativos de Markdown não concordam em como lidar com espaços no meio de uma URL. Por questão de compatibilidade, tente codificar espaços da URL com o código %20.

  Faça isso   Não Faça isso
[link](https://exemplo.com/minha%20pagina) [link](https://exemplo.com/minha página)

Imagens

Para adicionar uma imagem, adicione um ponto de exclamação (!), seguido pelo texto alternativo entre colchetes e o caminho ou URL da imagem entre parênteses. Opcionalmente, você pode adicionar um título após o URL ainda dentro dos parênteses.

![Markdown é a linguagem de marcação mais simples do mundo!](/assets/img/markdown.jpg "Logo do Markdown")

O Resultado fica assim:

Markdown é a linguagem de marcação mais simples do mundo!

Vinculando imagens

Para adicionar um link a uma imagem, coloque o Markdown da imagem entre colchetes e, em seguida, adicione o link entre parênteses.

[![Uma pedra antiga no deserto](/assets/img/shiprock.jpg "Shiprock, Novo México por Beau Rogers")](https://www.flickr.com/photos/beaurogers/31833779864/in/photolist-Qv3rFw-34mt9F-a9Cmfy-5Ha3Zi-9msKdv-o3hgjr-hWpUte-4WMsJ1-KUQ8N-deshUb-vssBD-6CQci6-8AFCiD-zsJWT-nNfsgB-dPDwZJ-bn9JGn-5HtSXY-6CUhAL-a4UTXB-ugPum-KUPSo-fBLNm-6CUmpy-4WMsc9-8a7D3T-83KJev-6CQ2bK-nNusHJ-a78rQH-nw3NvT-7aq2qf-8wwBso-3nNceh-ugSKP-4mh4kh-bbeeqH-a7biME-q3PtTf-brFpgb-cg38zw-bXMZc-nJPELD-f58Lmo-bXMYG-bz8AAi-bxNtNT-bXMYi-bXMY6-bXMYv)

O resultado:

Uma pedra antiga no deserto

Escapando caracteres

Para exibir um caractere literal que, de outra forma, seria usado para formatar texto em um documento Markdown, adicione uma barra invertida (\) na frente do caractere.

\* Sem a barra invertida, isso seria um elemento em uma lista não ordenada.

O Resultado fica assim:

* Sem a barra invertida, isso seria um elemento em uma lista não ordenada.

Caracteres que você pode escapar

Você pode usar uma barra invertida para escapar os seguintes caracteres.

Caractere Nome
\ barra invertida
` crase (veja também escapando crases no bloco de código)
* asterisco
_ sublinhado
{ } chaves
[ ] colchetes
( ) parênteses
# símbolo de número/hash/cerquilha
+ sinal de mais
- sinal de menos (hífen)
. ponto
! ponto de exclamação
| barra vertical/pipe (veja também escapando barras verticais em tabelas)

HTML

Muitos aplicativos Markdown permitem que você use tags HTML em texto formatado para Markdown. Isso é útil se você preferir usar determinadas tags em HTML ao invez da sintaxe do Markdown. Por exemplo, algumas pessoas acham mais fácil usar tags HTML para imagens. O uso de HTML também é útil quando você precisa alterar os atributos de um elemento, como especificar a cor do texto ou alterar a largura de uma imagem.

Para usar HTML, coloque as tags diretamento no texto do seu arquivo Markdown.

Essa **palavra** está em negrito. Essa <em>palavra</em> está em itálico.

O Resultado fica assim:

Essa palavra está em negrito. Essa palavra está em itálico.

Práticas recomendadas para o uso de HTML em Markdown

Por motivos de segurança, nem todos os aplicativos Markdown oferecem suporte a HTML nos documentos Markdown. Em caso de dúvida, verifique a documentação do seu aplicativo Markdown. Alguns aplicativos suportam apenas um subconjunto de tags HTML.

Use linhas em branco para separar elementos HTML em nível de bloco, como <div>, <table>, <pre>, e <p> do conteúdo circundante. Tente não recuar as tags com tabulações ou espaços — que podem interferir na formatação.

Você não pode usar a sintaxe do Markdown nas tags HTML no nível do bloco. Por exemplo, <p>itálico e **negrito**</p> não vai funcionar.