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.
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
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.
Além de apenas especificar o local onde seu texto deve aparecer, você pode também definir o estilo que ele deve ter.
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.
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
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:
😊
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.
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.
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;
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.
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
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)
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.
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
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. Este é um aninhado
2. Lista de itens
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 |
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
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.