Markdown - Sintáxe básica

---

baseado em https://www.markdownguide.org/basic-syntax/

---

Visão geral

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

Títulos

Para criar um título, adicione sinais numéricos (#) antes 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 título de nível três (<h3>), use três sinais numéricos (por exemplo, ### My Header).

Remarcação	HTML	Saída renderizada
# Heading level 1	<h1>Heading level 1</h1>	Heading level 1
# Heading level 2	<h2>Heading level 2</h2>	Heading level 1
# Heading level 3	<h3>Heading level 3</h3>	Heading level 3
# Heading level 4	<h4>Heading level 4</h4>	Heading level 4
# Heading level 5	<h5>Heading level 5</h5>	Heading level 5
# Heading level 6	<h6>Heading level 6</h6>	Heading level 6

Sintaxe Alternativa

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

Remarcação	HTML	Saída renderizada
Heading level 1 ===============	<h1>Heading level 1</h1>	Heading level 1
Heading level 2 ---------------	<h2>Heading level 2</h2>	Heading level 2

Cabeçalho Melhores Práticas

Os aplicativos de markdown não concordam sobre como lidar com a falta de espaço entre os sinais numéricos (#) e o nome do título. Para compatibilidade, sempre coloque um espaço entre os sinais numéricos e o nome do título.

✅  Faça isso	❌  Não faça isso
# Here's a Heading	#Here's a Heading

Você também deve colocar linhas em branco antes e depois de um título para compatibilidade.

✅ Faça assim	❌ Não assim
Try to put a blank line before... # Heading ...and after a heading.	Without blank lines, this might not look right. # Heading Don't do this!

Parágrafos

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

MarkDown	HTML	Saída renderizada
Paragrafo1. Paragrafo2.	<p>Paragrafo1.</p><p>Paragrafo2.</p>	Paragrafo1. Paragrafo2.

Melhores práticas de parágrafo

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

ℹ Nota: Se você precisar recuar parágrafos na saída, consulte a seção sobre como recuar (tabulação).

✅  Faça isso	❌  Não faça isso
Não coloque tabulações ou espaços antes dos parágrafos.	Isso pode resultar em problemas inesperados de formatação.
Mantenha as linhas alinhadas à esquerda assim.	Não adicione tabulações ou espaços antes dos parágrafos.

Quebras de linha

Para criar uma quebra de linha ou uma nova linha (<br>), termine uma linha com dois ou mais espaços e digite return.

Remarcação	HTML	Saída renderizada
Esta é a primeira linha.	Esta é a primeira linha.	Esta é a primeira linha.
E esta é a segunda linha.	E esta é a segunda linha.	E esta é a segunda linha.

Práticas recomendadas para quebra de linha

TODO #line-break-best-practices

Você pode usar dois ou mais espaços (comumente chamados de "espaços em branco finais") para quebras de linha em quase todos os aplicativos Markdown, mas isso é controverso. É difícil ver espaços em branco no final de um editor, e muitas pessoas acidentalmente ou intencionalmente colocam dois espaços após cada frase. Por esse motivo, você pode querer usar algo diferente de espaços em branco à direita para quebras de linha. Se o seu aplicativo Markdown suportar HTML, você poderá usar a <br> tag HTML.

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

Existem duas outras opções que não recomendo usar. 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 ótima 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 digitar return e elas criarão uma quebra de linha.

✅  Faça isso	❌  Não faça isso
First line with two spaces after.	Primeira linha com uma barra invertida depois.\
And the next line.	E a próxima linha.
First line with the HTML tag after.	Primeira linha sem nada depois.
And the next line.	E a próxima linha.

Ênfase

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

Negrito

Para texto em negrito, adicione dois asteriscos ou sublinhados antes e depois de uma palavra ou frase. Para colocar o meio de uma palavra em negrito para dar ênfase, adicione dois asteriscos sem espaços ao redor das letras.

Remarcação	HTML	Saída renderizada
Eu amo **texto em negrito**.	Eu adoro texto em negrito.	Eu adoro texto em negrito .
Eu amo __texto em negrito__.	Eu adoro texto em negrito.	Eu adoro texto em negrito .
O amor **é** negrito	O amorénegrito	O amor é negrito

Melhores práticas em negrito

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

✅  Faça isso	❌  Não faça isso
O amor **é** negrito	O amor__é__negrito

Itálico

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

Remarcação	HTML	Saída renderizada
O texto em itálico é o *miado do gato*.	O texto em itálico é o miado do gato.	O texto em itálico é o miado do gato .
O texto em itálico é o _miado do gato_.	O texto em itálico é o miado do gato.	O texto em itálico é o miado do gato .
Um *gato* miau	Um gato> miau	Um gato miau

Melhores práticas em itálico

TODO #italic-best-practices

Os aplicativos Markdown não concordam sobre como lidar com sublinhados no meio de uma palavra. Para compatibilidade, use asteriscos para colocar em itálico o meio de uma palavra para dar ênfase.

✅  Faça isso	❌  Não faça isso
Um *gato* miau	Um_gato_miau

Negrito e Itálico

TODO #bold-and-italic

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 colocar negrito e itálico no meio de uma palavra para dar ênfase, adicione três asteriscos sem espaços ao redor das letras.

Remarcação	HTML	Saída renderizada
Este texto é ***realmente importante***.	Este texto é <em><strong>realmente importante</strong></em>.	Este texto é realmente importante.
Este texto é ___realmente importante___.	Este texto é <em><strong>realmente importante</strong></em>.	Este texto é realmente importante.
Este texto é __*realmente importante*__.	Este texto é <em><strong>realmente importante</strong></em>.	Este texto é realmente importante.
Este texto é **_realmente importante**_.	Este texto é <em><strong>realmente importante</strong></em>.	Este texto é _realmente importante_.
Este texto é realmente ***muito*** importante.	Este texto é realmente <em><strong>muito importante</strong></em>.	Este texto é realmente muito importante.

ℹ Observação: a ordem das tags em e strong pode ser invertida dependendo do processador Markdown que você está usando.

Práticas recomendadas para negrito e itálico

TODO #bold-and-italic-best-practices

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

✅  Faça isso	❌  Não faça isso
Este texto é realmente ***muito*** importante.	Este texto é realmente___muito___importante.

Citações em bloco

Para criar uma citação em bloco, adicione um > antes de um parágrafo.

> Dorothy followed her through many of the beautiful rooms in her castle.

A saída renderizada fica assim:

Dorothy a seguiu por muitos dos belos quartos de seu castelo.

Citações em bloco com vários parágrafos

TODO #blockquotes-with-multiple-paragraphs

Aspas em bloco podem conter vários parágrafos. Adicione um > nas linhas em branco entre os parágrafos.

> Dorothy a seguiu por muitos dos belos quartos de seu castelo.

>

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

A saída renderizada fica assim:

Dorothy a seguiu por muitos dos belos quartos de seu castelo.

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

Citações aninhadas

TODO #nested-blockquotes

Aspas em bloco podem ser aninhadas. Adicione um >> antes do parágrafo que você deseja aninhar.

> Dorothy a seguiu por muitos dos belos quartos de seu castelo.

>

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

A saída renderizada fica assim:

Dorothy a seguiu por muitos dos belos quartos de seu castelo.

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

Blockquotes com outros elementos

TODO #blockquotes-with-other-elements

Blockquotes podem conter outros elementos formatados em Markdown. Nem todos os elementos podem ser usados ​​​​— você precisará experimentar para ver quais funcionam.

> #### Os resultados trimestrais parecem ótimos!

>

> - A receita estava fora do gráfico.

> - Os lucros foram maiores do que nunca.

>

> *Tudo* está indo conforme o **planejado** .

A saída renderizada fica assim:

Os resultados trimestrais parecem ótimos!

• A receita estava fora do gráfico.
• Os lucros foram maiores do que nunca.

Tudo está indo conforme o planejado.

Práticas recomendadas para citações em bloco

TODO #blockquotes-best-practices

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

✅  Faça isso	❌  Não faça isso
Tente colocar uma linha em branco antes...	Sem linhas em branco, isso pode não parecer certo.\
	> Esta é uma citação em bloco\
> Esta é uma citação em bloco	Não faça isso!\
...e depois de uma citação em bloco.

Listas

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

Listas ordenadas

TODO #ordered-lists

Para criar uma lista ordenada, adicione itens de linha com números seguidos de pontos. Os números não precisam estar em ordem numérica, mas a lista deve começar com o número um.

Remarcação	HTML	Saída renderizada
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</li> ㅤ<li>Quarto item</li> </ol>	1. Primeiro item 2. Segundo item 3. Terceiro item ㅤㅤ1. Item recuado ㅤㅤ2. Item recuado 4. Quarto item

Melhores práticas de lista ordenada

TODO #ordered-list-best-practices

CommonMark e algumas outras linguagens de marcação leves permitem usar parênteses ( )) como delimitador (por exemplo, 1) First item), mas nem todo Markdown os aplicativos suportam isso, portanto não é uma ótima opção do ponto de vista de compatibilidade. Para fins de compatibilidade, use apenas pontos.

✅  Faça isso	❌  Não faça isso
1. First item	1) First item
2. Second item	2) Second item

Listas não ordenadas

TODO #unordered-lists

Para criar uma lista não ordenada, adicione travessões ( - ), asteriscos ( * ) ou sinais de adição ( + ) na frente dos itens de linha. Recue um ou mais itens para criar uma lista aninhada.

Remarcação	HTML	Saída renderizada
- 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</li> ㅤ<li>Quarto item</li> </ul>	• Primeiro item • Segundo item • Terceiro item ㅤㅤ◦ Item recuado ㅤㅤ◦ Item recuado • Quarto item

Iniciando itens de lista não ordenados com números

TODO #starting-unordered-list-items-with-numbers

Se precisar iniciar um item de lista não ordenado com um número seguido de um ponto final, você pode usar uma barra invertida ( / ) para escapar do ponto.

Remarcação	HTML	Saída renderizada
- 1968. Um ótimo ano! - Acho que 1969 foi o segundo melhor.	<ul> ㅤ<li>1968. Um ótimo ano!</li> <li>Acho que 1969 foi o segundo melhor.</li> </ul>	• 1968. Um ótimo ano! • Acho que 1969 foi o segundo melhor.

Práticas recomendadas para lista não ordenada

TODO #unordered-list-best-practices

Os aplicativos Markdown não concordam sobre como lidar com diferentes delimitadores na mesma lista. Para compatibilidade, não misture e combine delimitadores na mesma lista – escolha um e mantenha-o.

✅  Faça isso	❌  Não faça isso
- Primeiro item - Segundo item - Terceiro item - Quarto item	+ Primeiro item * Segundo item - Terceiro item + Quarto item

Adicionando Elementos em Listas

TODO #adding-elements-in-lists

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

ℹ Dica: Se as coisas não aparecerem da maneira esperada, verifique novamente se você recuou os elementos da lista com quatro espaços ou uma tabulação.

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.

A saída renderizada 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.

Citações em bloco

TODO #blockquotes

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

    > Uma citação em bloco ficaria ótima abaixo do segundo item da lista.

* E aqui está o terceiro item da lista

A saída renderizada fica assim:

• Este é o primeiro item da lista.
• Aqui está o segundo item da lista. > Uma citação em bloco ficaria ótima abaixo do segundo item da lista.
• E aqui está o terceiro item da lista

Blocos de códigos

TODO #code-blocks-1

Os blocos de código normalmente são recuados com quatro espaços ou uma tabulação. Quando estiverem em uma lista, recue-os com 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>Test</title>
      </head>

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

A saída renderizada fica assim:

1. Abra o arquivo.

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

   <html>
     <head>
       <title>Test</title>
     </head>
   

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

Imagens

TODO #images

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

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

3. Feche o arquivo.

A saída renderizada fica assim:

1. Abra o arquivo que contém o mascote do Linux.

2. Maravilhe-se com sua beleza.

   

3. Feche o arquivo.

Listas

TODO #lists

Você pode aninhar uma lista não ordenada em uma lista ordenada ou vice-versa.

1. Primeiro item
2. Segundo item
3. Terceiro item
      - Item recuado
      - Item recuado
4. Quarto item

A saída renderizada fica assim:

1. Primeiro item
2. Segundo item
3. Terceiro item
   • Item recuado
   • Item recuado
4. Quarto item

Código

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

Remarcação	HTML	Saída renderizada
No prompt de comando, digite `Nano`.	No prompt de comando, digite Nano.	No prompt de comando, digite nano.

Escapando de crases

TODO #escaping-backticks

Se a palavra ou frase que você deseja denotar como código incluir um ou mais crases, você poderá escapar dela colocando a palavra ou frase entre crases duplos ( `` ).

Remarcação	HTML	Saída renderizada
Use `code` em seu arquivo Markdown.	Use code em seu arquivo Markdown.	Use ´code´ in your Markdown file.

Blocos de código

TODO #code-blocks

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

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

A saída renderizada fica assim:

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

ℹ Nota: Para criar blocos de código sem recuar linhas, use blocos de código protegidos.

Regras horizontais

Para criar uma regra horizontal, use três ou mais asteriscos ( *** ), travessões ( --- ) ou sublinhados ( ___ ) em uma linha sozinhos.

***
---
______________

A saída renderizada de todos os três parece idêntica:

---

Práticas recomendadas para regras horizontais

TODO #horizontal-rule-best-practices

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

✅  Faça isso	❌  Não faça isso
Tente colocar uma linha em branco antes... --- ...e depois de uma regra horizontal.	Sem linhas em branco, este seria um título. --- Não faça isso!

Ligações

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

My favorite search engine is [Duck Duck Go](https://duckduckgo.com).

A saída renderizada fica assim:

Meu mecanismo de pesquisa favorito é Duck Duck Go.

ℹ Nota: Para vincular a um elemento na mesma página, consulte vinculação a IDs de cabeçalho . Para criar um link que abre em uma nova guia ou janela, consulte a seção sobre destinos de link.

Adicionando títulos

TODO #adding-titles

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

My favorite search engine is [Duck Duck Go](https://duckduckgo.com "The best search engine for privacy").

A saída renderizada fica assim: Meu mecanismo de pesquisa favorito é Duck Duck Go.

URLs e endereços de e-mail

TODO #urls-and-email-addresses

Para transformar rapidamente um URL ou endereço de e-mail em um link, coloque-o entre colchetes angulares.

<https://www.markdownguide.org>
<fake@example.com>

A saída renderizada fica assim:

https://www.markdownguide.org

fake@example.com

Formatando links

TODO #formatting-links

Para enfatizar os links, adicione asteriscos antes e depois dos colchetes e parênteses. Para denotar links como code, adicione crases entre colchetes.

Adoro apoiar a **[EFF](https://eff.org)**.

Este é o *[Markdown Guide](https://www.markdownguide.org)*.

Consulte a seção sobre [`code`](#code).

A saída renderizada fica assim:

Adoro apoiar a EFF.

Este é o Markdown Guide.

Consulte a seção sobre code.

Links de estilo de referência

TODO #reference-style-links

Links de estilo de referência são um tipo especial de link que torna os URLs mais fáceis de exibir e ler no Markdown. Os links de estilo de referência são construídos em duas partes: a parte que você mantém alinhada ao seu texto e a parte que você armazena em outro lugar do arquivo para manter o texto fácil de ler.

Formatando a primeira parte do link

TODO #formatting-the-first-part-of-the-link

A primeira parte de um link de estilo de referência é formatada com dois conjuntos de colchetes. O primeiro conjunto de colchetes circunda 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 lugar do documento.

Embora não seja obrigató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 formatos de exemplo são aproximadamente equivalentes para a primeira parte do link:

• [hobbit-hole][1]
• [hobbit-hole][1]

Formatando a segunda parte do link

TODO #formatting-the-second-part-of-the-link

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, [label]: ).
2. O URL do link, que você pode colocar opcionalmente entre colchetes angulares.
3. O título opcional do link, que você pode colocar entre aspas duplas, aspas simples ou parênteses.

Isso significa que os formatos de exemplo a seguir são aproximadamente equivalentes para a segunda parte do link:

* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle
* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"
* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle 'Hobbit lifestyles'
* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle (Hobbit lifestyles)
* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"
* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle 'Hobbit lifestyles'
* [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle (Hobbit lifestyles)

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

Um exemplo juntando as peças

TODO #an-example-putting-the-parts-together

Digamos que você adicione um URL como um link de URL padrão a um parágrafo e ele ficará assim no Markdown:

Num buraco no chão vivia um hobbit. Não é um buraco nojento, sujo e molhado, cheio de pontas
de vermes e com cheiro de lodo, nem um buraco seco, vazio e arenoso, sem nada onde sentar ou onde sentar.
comer: era uma [toca de hobbit](https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"), e isso significa conforto.

Embora possa apontar para informações adicionais interessantes, o URL exibido realmente não acrescenta muito ao texto bruto existente, a não ser torná-lo mais difícil de ler. Para corrigir isso, você pode formatar o URL assim:

Em um buraco no chão vivia um hobbit. Não um buraco nojento, sujo e úmido, cheio de pontas de minhocas e com cheiro de lodo, nem ainda um buraco seco, vazio e arenoso, sem nada onde sentar ou comer: era um [buraco de hobbit](https://en.wikipedia.org/wiki/Hobbit#Lifestyle), e isso significa conforto.

Em ambos os casos acima, a saída renderizada seria idêntica:

Em um buraco no chão vivia um hobbit. Não um buraco nojento, sujo e úmido, cheio de pontas de minhocas e com cheiro de lodo, nem ainda um buraco seco, vazio e arenoso, sem nada onde sentar ou comer: era um buraco de hobbit, e isso significa conforto.

e o HTML do link seria:

<a href="https://en.wikipedia.org/wiki/Hobbit#Lifestyle title="Hobbit lifestyles">hobbit-hole</a>

Vincular práticas recomendadas

TODO #link-best-practices

Os aplicativos Markdown não concordam sobre como lidar com espaços no meio de um URL. Para compatibilidade, tente codificar em URL quaisquer espaços com 20%. Como alternativa, se seu aplicativo Markdown suportar HTML, você poderá usar a tag HTML.

✅  Faça isso	❌  Não faça isso
[link](https://www.example.com/my%20great%20page) <a href="https://www.example.com/my great page">link</a>	[link](https://www.example.com/my great page)

Parênteses no meio de um URL também podem ser problemáticos. Para compatibilidade, tente codificar em URL o parêntese de abertura (() com %28e o parêntese de fechamento ( )) com %29. Alternativamente, se o seu aplicativo Markdown suportar HTML , você poderá usar a atag HTML.

✅  Faça isso	❌  Não faça isso
[a novel](https://en.wikipedia.org/wiki/The_Milagro_Beanfield_War_%28novel%29) <a href="https://en.wikipedia.org/wiki/The_Milagro_Beanfield_War_(novel)">a novel</a>	[a novel](https://en.wikipedia.org/wiki/The_Milagro_Beanfield_War_(novel))

Imagens

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

![The San Juan Mountains are beautiful!](/assets/images/san-juan-mountains.jpg "San Juan Mountains")

A saída renderizada fica assim:

ℹ Nota: Para redimensionar uma imagem, consulte a seção sobre tamanho da imagem . Para adicionar uma legenda, consulte a seção sobre legendas de imagens.

Vinculando imagens

TODO #linking-images

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

[![An old rock in the desert](/assets/images/shiprock.jpg "Shiprock, New Mexico by 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)

A saída renderizada fica assim:

Caracteres escapando

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.

\* Without the backslash, this would be a bullet in an unordered list.

A saída renderizada fica assim:

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

Caracteres dos quais você pode escapar

TODO #characters-you-can-escape

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

Caracteres	Nome
\	barra invertida
`	backtick (veja também escapando de backticks no código)
*	asterisco
_	sublinhado
{}	chaves
[]	colchetes
<>	colchetes angulares
()	parênteses
#	cerquilha.
+	sinal de mais
-	sinal de menos (hífen)
.	ponto
!	ponto de exclamação

HTML

Muitos aplicativos Markdown permitem usar tags HTML em texto formatado em Markdown. Isso é útil se você preferir certas tags HTML à sintaxe Markdown. Por exemplo, algumas pessoas acham mais fácil usar tags HTML para imagens. Usar 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 no texto do seu arquivo formatado em Markdown.

This **word** is bold. This <em>word</em> is italic.

A saída renderizada fica assim:

Esta palavra é ousada. Esta palavra está em itálico.

Práticas recomendadas de HTML

TODO #html-best-practices

Por motivos de segurança, nem todos os aplicativos Markdown suportam HTML em 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>, e do conteúdo circundante. Tente não recuar as tags com tabulações ou espaços — isso pode interferir na formatação.<table><pre><p>

Você não pode usar a sintaxe Markdown dentro de tags HTML em nível de bloco. Por exemplo, <p>italic and **bold**</p> não funcionará. F

Emojis

Emoji para MarkDown

People

:bowtie: :bowtie:	:smile:	:laughing:
:blush:	:smiley:	:relaxed:
:smirk:	:heart_eyes:	:kissing_heart:
:kissing_closed_eyes:	:flushed:	:relieved:
:satisfied:	:grin:	:wink:
:stuck_out_tongue_winking_eye:	:stuck_out_tongue_closed_eyes:	:grinning:
:kissing:	:kissing_smiling_eyes:	:stuck_out_tongue:
:sleeping:	:worried:	:frowning:
:anguished:	:open_mouth:	:grimacing:
:confused:	:hushed:	:expressionless:
:unamused:	:sweat_smile:	:sweat:
:disappointed_relieved:	:weary:	:pensive:
:disappointed:	:confounded:	:fearful:
:cold_sweat:	:persevere:	:cry:
:sob:	:joy:	:astonished:
:scream:	:neckbeard: :neckbeard:	:tired_face:
:angry:	:rage:	:triumph:
:sleepy:	:yum:	:mask:
:sunglasses:	:dizzy_face:	:imp:
:smiling_imp:	:neutral_face:	:no_mouth:
:innocent:	:alien:	:yellow_heart:
:blue_heart:	:purple_heart:	:heart:
:green_heart:	:broken_heart:	:heartbeat:
:heartpulse:	:two_hearts:	:revolving_hearts:
:cupid:	:sparkling_heart:	:sparkles:
:star:	:star2:	:dizzy:
:boom:	:collision:	:anger:
:exclamation:	:question:	:grey_exclamation:
:grey_question:	:zzz:	:dash:
:sweat_drops:	:notes:	:musical_note:
:fire:	:hankey:	:poop:
:shit:	:+1:	:thumbsup:
:-1:	:thumbsdown:	:ok_hand:
:punch:	:facepunch: :facepunch:	:fist:
:v:	:wave:	:hand: :hand:
:raised_hand:	:open_hands:	:point_up:
:point_down:	:point_left:	:point_right:
:raised_hands:	:pray:	:point_up_2:
:clap:	:muscle:	:metal:
:fu: :fu:	:walking:	:runner:
:running: :running:	:couple:	:family:
:two_men_holding_hands:	:two_women_holding_hands:	:dancer:
:dancers:	:ok_woman:	:no_good:
:information_desk_person:	:raising_hand:	:bride_with_veil: :bride_with_veil:
:person_with_pouting_face:	:person_frowning:	:bow:
:couplekiss:	:couple_with_heart:	:massage:
:haircut:	:nail_care:	:boy:
:girl:	:woman:	:man:
:baby:	:older_woman:	:older_man:
:person_with_blond_hair:	:man_with_gua_pi_mao:	:man_with_turban:
:construction_worker:	:cop:	:angel:
:princess:	:smiley_cat:	:smile_cat:
:heart_eyes_cat:	:kissing_cat:	:smirk_cat:
:scream_cat:	:crying_cat_face:	:joy_cat:
:pouting_cat:	:japanese_ogre:	:japanese_goblin:
:see_no_evil:	:hear_no_evil:	:speak_no_evil:
:guardsman:	:skull:	:feet:
:lips:	:kiss:	:droplet:
:ear:	:eyes:	:nose:
:tongue:	:love_letter:	:bust_in_silhouette:
:busts_in_silhouette:	:speech_balloon:	:thought_balloon:
:feelsgood: :feelsgood:	:finnadie: :finnadie:	:goberserk: :goberserk:
:godmode: :godmode:	:hurtrealbad: :hurtrealbad:	:rage1: :rage1:
:rage2: :rage2:	:rage3: :rage3:	:rage4: :rage4:
:suspect: :suspect:	:trollface: :trollface:

Nature

:sunny:	:umbrella:	:cloud:
:snowflake:	:snowman:	:zap:
:cyclone:	:foggy:	:ocean:
:cat:	:dog:	:mouse:
:hamster:	:rabbit:	:wolf:
:frog:	:tiger:	:koala:
:bear:	:pig:	:pig_nose:
:cow:	:boar:	:monkey_face:
:monkey:	:horse:	:racehorse:
:camel:	:sheep:	:elephant:
:panda_face:	:snake:	:bird:
:baby_chick:	:hatched_chick:	:hatching_chick:
:chicken:	:penguin:	:turtle:
:bug:	:honeybee:	:ant:
:beetle:	:snail:	:octopus:
:tropical_fish:	:fish:	:whale:
:whale2:	:dolphin:	:cow2:
:ram:	:rat:	:water_buffalo:
:tiger2:	:rabbit2:	:dragon:
:goat:	:rooster:	:dog2:
:pig2:	:mouse2:	:ox:
:dragon_face:	:blowfish:	:crocodile:
:dromedary_camel:	:leopard:	:cat2:
:poodle:	:paw_prints:	:bouquet:
:cherry_blossom:	:tulip:	:four_leaf_clover:
:rose:	:sunflower:	:hibiscus:
:maple_leaf:	:leaves:	:fallen_leaf:
:herb:	:mushroom:	:cactus:
:palm_tree:	:evergreen_tree:	:deciduous_tree:
:chestnut:	:seedling:	:blossom:
:ear_of_rice:	:shell:	:globe_with_meridians:
:sun_with_face:	:full_moon_with_face:	:new_moon_with_face:
:new_moon:	:waxing_crescent_moon:	:first_quarter_moon:
:waxing_gibbous_moon:	:full_moon:	:waning_gibbous_moon:
:last_quarter_moon:	:waning_crescent_moon:	:last_quarter_moon_with_face:
:first_quarter_moon_with_face:	:moon: :moon:	:earth_africa:
:earth_americas:	:earth_asia:	:volcano:
:milky_way:	:partly_sunny:	:octocat: :octocat:
:squirrel: :squirrel:

Objects

:bamboo:	:gift_heart:	:dolls:
:school_satchel:	:mortar_board:	:flags:
:fireworks:	:sparkler:	:wind_chime:
:rice_scene:	:jack_o_lantern:	:ghost:
:santa:	:christmas_tree:	:gift:
:bell:	:no_bell:	:tanabata_tree:
:tada:	:confetti_ball:	:balloon:
:crystal_ball:	:cd:	:dvd:
:floppy_disk:	:camera:	:video_camera:
:movie_camera:	:computer:	:tv:
:iphone: :iphone:	:phone: :phone:	:telephone:
:telephone_receiver:	:pager:	:fax:
:minidisc:	:vhs:	:sound:
:speaker:	:mute:	:loudspeaker:
:mega:	:hourglass:	:hourglass_flowing_sand:
:alarm_clock:	:watch:	:radio:
:satellite:	:loop:	:mag:
:mag_right:	:unlock:	:lock:
:lock_with_ink_pen:	:closed_lock_with_key:	:key:
:bulb:	:flashlight:	:high_brightness:
:low_brightness:	:electric_plug:	:battery:
:calling:	:email:	:mailbox:
:postbox:	:bath:	:bathtub:
:shower:	:toilet:	:wrench:
:nut_and_bolt:	:hammer:	:seat:
:moneybag:	:yen:	:dollar:
:pound:	:euro:	:credit_card:
:money_with_wings:	:e-mail:	:inbox_tray:
:outbox_tray:	:envelope:	:incoming_envelope:
:postal_horn:	:mailbox_closed:	:mailbox_with_mail:
:mailbox_with_no_mail:	:door:	:smoking:
:bomb:	:gun:	:hocho: :hocho:
:pill:	:syringe:	:page_facing_up:
:page_with_curl:	:bookmark_tabs:	:bar_chart:
:chart_with_upwards_trend:	:chart_with_downwards_trend:	:scroll:
:clipboard:	:calendar:	:date:
:card_index:	:file_folder:	:open_file_folder:
:scissors:	:pushpin:	:paperclip:
:black_nib:	:pencil2:	:straight_ruler:
:triangular_ruler:	:closed_book:	:green_book:
:blue_book:	:orange_book:	:notebook:
:notebook_with_decorative_cover:	:ledger:	:books:
:bookmark:	:name_badge:	:microscope:
:telescope:	:newspaper:	:football:
:basketball:	:soccer:	:baseball:
:tennis:	:8ball:	:rugby_football:
:bowling:	:golf:	:mountain_bicyclist:
:bicyclist:	:horse_racing:	:snowboarder:
:swimmer:	:surfer:	:ski:
:spades:	:hearts:	:clubs:
:diamonds:	:gem:	:ring:
:trophy:	:musical_score:	:musical_keyboard:
:violin:	:space_invader:	:video_game:
:black_joker:	:flower_playing_cards:	:game_die:
:dart:	:mahjong:	:clapper:
:memo:	:pencil:	:book:
:art:	:microphone:	:headphones:
:trumpet:	:saxophone:	:guitar:
:shoe: :shoe:	:sandal:	:high_heel:
:lipstick:	:boot:	:shirt:
:tshirt: :tshirt:	:necktie:	:womans_clothes:
:dress:	:running_shirt_with_sash:	:jeans:
:kimono:	:bikini:	:ribbon:
:tophat:	:crown:	:womans_hat:
:mans_shoe:	:closed_umbrella:	:briefcase:
:handbag:	:pouch:	:purse:
:eyeglasses:	:fishing_pole_and_fish:	:coffee:
:tea:	:sake:	:baby_bottle:
:beer:	:beers:	:cocktail:
:tropical_drink:	:wine_glass:	:fork_and_knife:
:pizza:	:hamburger:	:fries:
:poultry_leg:	:meat_on_bone:	:spaghetti:
:curry:	:fried_shrimp:	:bento:
:sushi:	:fish_cake:	:rice_ball:
:rice_cracker:	:rice:	:ramen:
:stew:	:oden:	:dango:
:egg:	:bread:	:doughnut:
:custard:	:icecream:	:ice_cream:
:shaved_ice:	:birthday:	:cake:
:cookie:	:chocolate_bar:	:candy:
:lollipop:	:honey_pot:	:apple:
:green_apple:	:tangerine:	:lemon:
:cherries:	:grapes:	:watermelon:
:strawberry:	:peach:	:melon:
:banana:	:pear:	:pineapple:
:sweet_potato:	:eggplant:	:tomato:
:corn:

Places

:house:	:house_with_garden:	:school:
:office:	:post_office:	:hospital:
:bank:	:convenience_store:	:love_hotel:
:hotel:	:wedding:	:church:
:department_store:	:european_post_office:	:city_sunrise:
:city_sunset:	:japanese_castle:	:european_castle:
:tent:	:factory:	:tokyo_tower:
:japan:	:mount_fuji:	:sunrise_over_mountains:
:sunrise:	:stars:	:statue_of_liberty:
:bridge_at_night:	:carousel_horse:	:rainbow:
:ferris_wheel:	:fountain:	:roller_coaster:
:ship:	:speedboat:	:boat: :boat:
:sailboat:	:rowboat:	:anchor:
:rocket:	:airplane:	:helicopter:
:steam_locomotive:	:tram:	:mountain_railway:
:bike:	:aerial_tramway:	:suspension_railway:
:mountain_cableway:	:tractor:	:blue_car:
:oncoming_automobile:	:car: :car:	:red_car:
:taxi:	:oncoming_taxi:	:articulated_lorry:
:bus:	:oncoming_bus:	:rotating_light:
:police_car:	:oncoming_police_car:	:fire_engine:
:ambulance:	:minibus:	:truck:
:train:	:station:	:train2:
:bullettrain_front:	:bullettrain_side:	:light_rail:
:monorail:	:railway_car:	:trolleybus:
:ticket:	:fuelpump:	:vertical_traffic_light:
:traffic_light:	:warning:	:construction:
:beginner:	:atm:	:slot_machine:
:busstop:	:barber:	:hotsprings:
:checkered_flag:	:crossed_flags:	:izakaya_lantern:
:moyai:	:circus_tent:	:performing_arts:
:round_pushpin:	:triangular_flag_on_post:	:jp:
:kr:	:cn:	:us:
:fr:	:es:	:it:
:ru:	:gb:	:uk: :uk:
:de:

Symbols

:one:	:two:	:three:
:four:	:five:	:six:
:seven:	:eight:	:nine:
:keycap_ten:	:1234:	:zero:
:hash:	:symbols:	:arrow_backward:
:arrow_down:	:arrow_forward:	:arrow_left:
:capital_abcd:	:abcd:	:abc:
:arrow_lower_left:	:arrow_lower_right:	:arrow_right:
:arrow_up:	:arrow_upper_left:	:arrow_upper_right:
:arrow_double_down:	:arrow_double_up:	:arrow_down_small:
:arrow_heading_down:	:arrow_heading_up:	:leftwards_arrow_with_hook:
:arrow_right_hook:	:left_right_arrow:	:arrow_up_down:
:arrow_up_small:	:arrows_clockwise:	:arrows_counterclockwise:
:rewind:	:fast_forward:	:information_source:
:ok:	:twisted_rightwards_arrows:	:repeat:
:repeat_one:	:new:	:top:
:up:	:cool:	:free:
:ng:	:cinema:	:koko:
:signal_strength:	:u5272:	:u5408:
:u55b6:	:u6307:	:u6708:
:u6709:	:u6e80:	:u7121:
:u7533:	:u7a7a:	:u7981:
:sa:	:restroom:	:mens:
:womens:	:baby_symbol:	:no_smoking:
:parking:	:wheelchair:	:metro:
:baggage_claim:	:accept:	:wc:
:potable_water:	:put_litter_in_its_place:	:secret:
:congratulations:	:m:	:passport_control:
:left_luggage:	:customs:	:ideograph_advantage:
:cl:	:sos:	:id:
:no_entry_sign:	:underage:	:no_mobile_phones:
:do_not_litter:	:non-potable_water:	:no_bicycles:
:no_pedestrians:	:children_crossing:	:no_entry:
:eight_spoked_asterisk:	:eight_pointed_black_star:	:heart_decoration:
:vs:	:vibration_mode:	:mobile_phone_off:
:chart:	:currency_exchange:	:aries:
:taurus:	:gemini:	:cancer:
:leo:	:virgo:	:libra:
:scorpius:	:sagittarius:	:capricorn:
:aquarius:	:pisces:	:ophiuchus:
:six_pointed_star:	:negative_squared_cross_mark:	:a:
:b:	:ab:	:o2:
:diamond_shape_with_a_dot_inside:	:recycle:	:end:
:on:	:soon:	:clock1:
:clock130:	:clock10:	:clock1030:
:clock11:	:clock1130:	:clock12:
:clock1230:	:clock2:	:clock230:
:clock3:	:clock330:	:clock4:
:clock430:	:clock5:	:clock530:
:clock6:	:clock630:	:clock7:
:clock730:	:clock8:	:clock830:
:clock9:	:clock930:	:heavy_dollar_sign:
:copyright:	:registered:	:tm:
:x:	:heavy_exclamation_mark: :heavy_exclamation_mark:	:bangbang:
:interrobang:	:o:	:heavy_multiplication_x:
:heavy_plus_sign:	:heavy_minus_sign:	:heavy_division_sign:
:white_flower:	:100:	:heavy_check_mark:
:ballot_box_with_check:	:radio_button:	:link:
:curly_loop:	:wavy_dash:	:part_alternation_mark:
:trident:	:black_square: :black_square:	:white_square: :white_square:
:white_check_mark:	:black_square_button:	:white_square_button:
:black_circle:	:white_circle:	:red_circle:
:large_blue_circle: :large_blue_circle:	:large_blue_diamond:	:large_orange_diamond:
:small_blue_diamond:	:small_orange_diamond:	:small_red_triangle:
:small_red_triangle_down:	:shipit: :shipit:

Referências

• https://www.markdownguide.org/basic-syntax/