O Markdown é uma linguagem simples projetada para simplificar a escrita de conteúdo. É usado em todos os lugares, desde o GitHub até aplicativos de anotações. Se você é um escritor, desenvolvedor ou apenas alguém que deseja simplificar sua escrita na web, este guia é para você!
Markdown é uma linguagem de marcação leve, criada por John Gruber em 2004, para tornar o texto formatado facilmente legível em editores de texto simples. É especialmente popular para blogs, mensagens instantâneas, fóruns, ferramentas colaborativas, documentação e arquivos readme. Com o tempo, variações em sua interpretação levaram à criação do CommonMark em 2014, uma especificação mais clara com um conjunto de testes para garantir uma implementação consistente.
Aqui está uma rápida descrição dos elementos mais comuns que você precisará:
Os cabeçalhos são criados usando o símbolo #
, seguido por um espaço:
# Isto é um H1
## Isto é um H2
### Isto é um H3
Para itálico use *asteriscos*
ou _sublinhados_
.
Para negrito use **dois asteriscos**
ou __dois sublinhados__
.
Use asteriscos, mais, ou menos seguido de um espaço:
* Item 1
* Item 2
* Subitem 2.1
* Subitem 2.2
Simplesmente use números seguidos por pontos:
1. Primeiro item
2. Segundo item
3. Terceiro item
Você pode criar um link inline com a seguinte sintaxe:
[Texto exibido](URL "Título opcional")
As imagens são semelhantes aos links, mas com um ponto de exclamação à frente:
![Texto Alternativo](URL "Título opcional")
Para blockquotes, use o caractere >
antes do seu texto:
> Este é um blockquote.
Para código
inline, envolva seu código com acentos graves:
`código aqui`
Para blocos de código de várias linhas, use três acentos graves:
\```
Linha 1 do código
Linha 2 do código
Linha 3 do código
\```
Você pode criar uma linha horizontal com três traços, asteriscos ou sublinhados:
---
| Cabeçalho1 | Cabeçalho2 |
|-----------|-----------|
| célula1 | célula2 |
| célula3 | célula4 |
- [x] Tarefa concluída
- [ ] Tarefa não concluída
Use ~~
para riscar o texto:
~~riscado~~
No seu arquivo Markdown, você pode adicionar citações usando o símbolo @
seguido pela chave de citação. Por exemplo:
De acordo com estudos recentes [@Smith2023], o efeito é...
Você também pode usar várias citações:
Alguns estudiosos argumentam este ponto [@Smith2023; @Doe2022].
Parentéticas (ou no texto) colocam o autor e o ano entre parênteses:
Este fenômeno foi observado em vários contextos (por exemplo, [@Smith2023]).
Narrativas incorporam o autor diretamente na frase:
De acordo com @Smith2023, o fenômeno...
Você pode fornecer locais mais específicos ou qualificadores para suas citações adicionando prefixos, localizadores e sufixos:
Como foi bem apontado [-@Smith2023, p. 23; veja também @Doe2022, ch. 2].
[@Smith2023, p. 23-25]
[@Doe2022, ch. 2]
Observe o uso de -
antes de @Smith2023
. Isso impede que o nome do autor seja repetido quando você deseja uma citação parentética. Sem o -
, seria tratado como uma citação narrativa.
Para criar e gerenciar sua bibliografia, recomendamos usar CiteDrive. CiteDrive é um gerenciador de referências nativo do BibTeX, colaborativo e baseado na nuvem, projetado especificamente para usuários Overleaf, LaTeX e R Markdown. Ele simplifica o processo de curar e gerenciar citações para seus documentos acadêmicos, teses ou qualquer outro tipo de publicação.
Vamos terminar com uma rápida introdução sobre como adicionar um vídeo ao seu arquivo Markdown.
Para incorporar um vídeo de uma plataforma como o YouTube, você geralmente precisará usar o código embed fornecido por essa plataforma.
<iframe width="560" height="315" src="https://www.youtube.com/embed/VIDEO_ID" frameborder="0" allowfullscreen></iframe>
Substitua “VIDEO_ID” pelo identificador específico do vídeo que deseja incorporar. Tenha em mente que a maneira exata de incorporar um vídeo pode variar dependendo da plataforma e do host de seu site.
Espero que você tenha encontrado este guia útil! Se você tiver alguma pergunta ou comentário, sinta-se à vontade para entrar em contato conosco. Boa sorte na sua jornada de escrita com Markdown!