Conheça os comandos essenciais do Markdown que você precisa saber

Criado em 20 de Agosto de 2023

A principal finalidade do Markdown é estilizar e formatar o texto. Neste contexto, vamos abordar os layouts básicos de texto que podem ser criados com o Markdown. Além disso, para criar um arquivo markdown, basta adicionar a extensão .mdao nome do arquivo.

Títulos

O Markdown possui seis níveis de cabeçalhos, assim como o HTML. Para criar títulos no Markdown, basta adicionar de um a seis #antes do texto do título, separado por um espaço. Cada #representa um nível de título, sendo que um #indica o título maior e seis ######indicam o título menor. Aqui está um exemplo de todos os seis níveis de títulos.

# Cabeçalho 1

## Cabeçalho 2

### Cabeçalho 3

#### Cabeçalho 4

##### Cabeçalho 5

###### Cabeçalho 6

Cabeçalho 1

Cabeçalho 2

Cabeçalho 3

Cabeçalho 4

Cabeçalho 5
Cabeçalho 6

Parágrafos

Os parágrafos no Markdown têm um formato de texto pré-definido. Ao digitar o texto, ele será convertido automaticamente em um parágrafo. A única coisa importante a lembrar sobre o Markdown é que, se você quiser separar o texto em dois parágrafos distintos, é necessário adicionar uma linha em branco entre cada conjunto de texto. Caso queira apenas uma nova linha dentro do mesmo parágrafo, basta adicionar dois espaços no final da linha e ela será convertida em uma nova linha.

Estilização de texto

Além de apenas especificar o local onde seu texto deve aparecer, você pode também definir o estilo que ele deve ter.

Negrito/Itálico

Negrito e itálico são as duas formas mais frequentes de formatar texto. Para aplicar negrito, você pode usar um *ou _ao redor do texto desejado e para itálico, para negrito basta usar dois *ou dois _.

*Este é um texto em itálico*

_Este também é um texto em itálico_

**Este é um texto em negrito**

__Este também é um texto em negrito__

Este é um texto em itálico

Este também é um texto em itálico

Este é um texto em negrito

Este também é um texto em negrito

Caso queira combinar negrito e itálico, você pode simplesmente digitar três asterisco *ou em três underline _assim ficaria em negrito e itálico.

***Isso é ambos***

___Isso também é ambos___

Isso é ambos

Isso também é ambos

Regularmente, é recomendado optar por *ao invés de, _já que em algumas situações o Markdown pode não funcionar adequadamente se houver _no meio de uma palavra.

Tachado

Aqui temos o nosso primeiro recurso estendido de Markdown. Para criar um texto tachado, você precisa dividir o texto em dois ~caracteres.

~~Texto deletado~~

Texto deletado

Emoji

Para adicionar um emoji, basta digitar :EMOJI_NAME:e ele será convertido em um emoji. Comparado a outros recursos estendidos do Markdown mencionados, este recurso tem um suporte muito menor. No entanto, você pode adicionar emojis copiando e colando-os no seu Markdown.

:smile:

😊

Código de manipulação

Uma das maneiras mais usuais de utilizar o Markdown é para mostrar código. Por padrão, você pode apresentar o código no meio do texto ou em um bloco.

Código embutido

Para mostrar o código embutido, basta envolvê-lo em um único `caractere. Isso é útil quando se deseja exibir pequenos trechos de código em um parágrafo.

Isso está em `inline code` dentro de um parágrafo.

Isso está em inline code dentro de um parágrafo.

Blocos de código

Uma forma de exibir um bloco maior de código é agrupá-lo em três `caracteres. Além disso, para realçar a sintaxe, você pode adicionar o idioma do bloco de código depois dos três `caracteres. Essa é uma funcionalidade avançada do Markdown, mas é compatível com a maioria das variantes do Markdown.

```js
// Este é um bloco de código
const a = 5;
```

                 

// Este é um bloco de código
const a = 5;

Outros elementos

Até este ponto, focamos em como estilizar o texto e exibir o código, porém o Markdown conta ainda com suporte para outras funcionalidades.

links

Se você quiser criar um link, basta colocar o texto entre colchetes e, em seguida, incluir o link entre parênteses. É possível até criar links relativos dessa maneira. Se você incluir um URL sozinho, se você estiver usando certos tipos de Markdown estendidos, ele será convertido automaticamente em um link; caso contrário, basta envolvê-lo em <>para que ele se torne um link.

[Este é um link]
(https:leodkvt.com.br)

[Relativo]
(/blog-markdown/markdown)

https:leodkvt.com.br

Imagens

A aparência das imagens é bastante semelhante aos links, uma vez que são agrupadas entre colchetes e parênteses. A única distinção está na necessidade de adicionar um ponto de exclamação antes dos colchetes. Além disso, o texto entre colchetes é utilizado como uma descrição alternativa da imagem, enquanto o link entre parênteses indica a fonte da imagem.

![Vscode Logo](/Assets/images/vscode.svg)

logo vscode

Citações em bloco

As blockquotes servem para fazer citações de outras fontes. Para criar uma blockquote, basta adicionar o caractere >antes do texto desejado. É possível, ainda, aninhar blockquotes adicionando múltiplos caracteres >.

Isso é uma citação de bloco

Esta é uma citação em bloco aninhada

Este é um exemplo de citação de bloco.

Este é um exemplo de citação de bloco aninhada.

Régua horizontal

Para inserir uma régua horizontal, coloque três ou mais caracteres -, _ou *em uma única linha.

Isso está acima da régua horizontal

***

Isso está entre as regras horizontais

---

Isso está entre as regras horizontais

___

Isso está abaixo da régua horizontal

Isso está acima da régua horizontal

Isso está entre as regras horizontais

Isso está entre as regras horizontais

Isso está abaixo da régua horizontal

Listas

Markdown possui dois tipos de listas: ordenadas e não ordenadas. Para criar uma lista não ordenada, adicione um dos seguintes caracteres no início de cada item: -, *, ou +. Para criar uma lista ordenada, adicione um número seguido de um .ponto antes de cada item, independentemente da ordem em que os números são utilizados. É possível também aninhar listas ao adicionar quatro espaços ou uma tabulação para recuar os itens.

- Esta é uma lista não ordenada
- De itens

1. Esta é uma lista ordenada
2. Os números não importam
1. Isso diz 3
* Esta é uma lista aninhada
* De itens

1. Este é um aninhado
2. Lista de itens

  • Esta é uma lista não ordenada
  • de itens
  1. Esta é uma lista ordenada
  2. Os números não importam
  3. Isso diz 3
    • Esta é uma lista aninhada
    • De itens
      1. Este é um aninhado
      2. Lista de itens

Tabelas

As tabelas possuem uma complexidade um pouco maior em comparação com os outros elementos que abordamos até agora. A criação de uma tabela envolve a construção de uma lista de linhas, em que cada coluna é separada por um |. Cada linha deve iniciar e terminar com um |. Logo abaixo da primeira linha, é necessário inserir uma linha contendo pelo menos três - para cada coluna, além da possibilidade de incluir : em ambos os lados dos -. O :é utilizado para alinhar o texto na coluna. Se colocado no lado esquerdo dos -, o texto será alinhado à esquerda. Se colocado no lado direito, o texto ficará alinhado à direita. Caso seja colocado em ambos os lados, o texto será alinhado ao centro. Por fim, é possível adicionar mais linhas à tabela seguindo o mesmo formato da primeira linha. Embora pareça complicado, quando visto em ação, tudo faz sentido.

| Coluna1 | Coluna2 |
| --- | --- |
| Não precisa | Ser |
| Alinhado | Apropriadamente |
| Essas | Colunas |

| Right | Center | Left |
| -----: | :----: | :--- |
| R | C | L |

Coluna 1 Coluna 2
Não precisa Ser
Alinhado Apropriadamente
Essas Colunas
Right Center Left
R C L

Lista de controle

Chegamos ao último elemento da nossa discussão, que é a lista de verificação. Essa funcionalidade faz parte do Markdown avançado e também é suportada pelo GitHub Flavored Markdown. Para criar uma lista de verificação, basta adicionar um - [ ]ou - [x]antes de cada item da lista. Utilize - [ ]para criar uma caixa de seleção não marcada, e - [x]para criar uma caixa de seleção marcada.

- [ ] Desmarcado
- [x] Verificado

Conclusão

Em termos de potencial, o Markdown realmente não conhece limites, pois não apenas capacita os usuários a dominar facilmente a arte do estilo de texto, permitindo que eles destaquem, coloquem em itálico ou negrito conteúdo importante conforme desejado, mas também vão além ao fornecendo uma variedade de recursos adicionais, como criação de listas, tabelas, inserção de imagens ou hiperlinks, incorporação contínua de blocos de código e muito mais, transformando a experiência geral de edição de texto em uma experiência incrivelmente versátil e rica.

Olá 👋! Se você gostou deste blog, por favor, ajude a divulgá-lo para que mais pessoas possam acessá-lo.
Você pode compartilhá-lo nas seguintes plataformas:

logo twitter logo facebook logo linkedin logo whatsapp logo gmail logo email