Olá, bem vindos ao meu tutorial de Markdown.
Neste tutorial você aprenderá o básico sobre Markdown.
Versão em espanhol disponível aqui.
Tabelas de conteúdo
De acordo com a Wikipedia :
Markdown é uma linguagem de marcação leve com sintaxe de formatação de texto simples projetada para que ela possa ser convertida em HTML e muitos outros formatos usando uma ferramenta com o mesmo nome. Markdown é usado frequentemente para formatar arquivos readme, para escrever mensagens em fóruns de discussão on-line e para criar texto rico usando um editor de texto simples.
SIMPLESMENTE: É APENAS OUTRO TIPO DE ARQUIVO DE TEXTO, COMO .txt .doc .... (agora é .md :risos:) E COM UMA SINTAXE ESPECIAL.
Não existe um padrão de Markdown claramente definido. Isso levou à fragmentação, pois fornecedores diferentes escrevem suas próprias variantes do idioma para corrigir falhas ou adicionar recursos faltantes. Uma lista de versões de Markdown está disponível aqui.
A partir de agora, este guia se concentrará principalmente na versão Markdown para Github .
Porque é :
- FÁCIL : A sintaxe é tão fácil que você pode aprender em um minuto ou dois, em seguida, escreva sem perceber nada estranho ou nerd.
- RÁPIDO : Ele economiza tempo em comparação com outros tipos de arquivos / formatos de texto. Isso ajuda a aumentar a produtividade e os fluxos de trabalho do escritor.
- LIMPO : Tanto a sintaxe como a saída são limpas, sem confusão com nossos olhos e simples de gerenciar.
- FLEXÍVEL : Com apenas algumas configurações, o seu texto será traduzido atravessando qualquer plataforma lá fora, editável em qualquer software de edição de texto e conversível para uma ampla variedade de formatos.
Em resumo, os usuários comuns acharão útil em todos os casos, especialmente quando você precisar de algo melhor que o texto simples, mas menos funcional do que o Microsoft Word.
Para desenvolvedores, Se você é preguiçoso para escrever código HTML, você vai adorar o markdown. Além disso, Github e muitos sites favorecem o markdown para o arquivo readme de projetos. Isso significa que você vai encontrar o markdown em sua vida de uma forma ou de outra.
Conforme mencionado acima, qualquer editor pode ser usado para editar o markdown. No entanto, existem algumas ferramentas que podem ser úteis para você quando se trata de editar markdown.
- Stackedit : Ok, você pode parar de ler agora. Clique no link e, em seguida, comece o seu turno de markdown de uma maneira mais rápida. Basta digitar o texto normal e depois usar o mouse, clique no botão. Você não precisa saber a sintaxe. É bom, mas fará você dependende, e a maioria dos desenvolvedores prefere os teclados.
- Dillinger : Ferramenta on-line, suporte em exibição ao vivo (tela dividida) e exportação para html. Nada muito especial, mas muito limpo e acessível.
- Typora : Disponível para Mac e Windows, mínimo, livre de distração, vista ao vivo sem parecer, empacotada com muitas outras coisas como Imagens, Listas, Tabelas, Cercas de Código, Blocos de Matemática, YAML, Front Matters, Toc, ...
- Atom : Editor de texto popular hackeável (você pode estar usando isso). Sim, isso é versátil. Suporte Markdown? Apenas uma parte disso, mas é muito construído.
- Minimalist Markdown : Aplicativo do Google Chrome. Funciona em todos os lugares se você tiver o Chrome instalado (este é o meu favorito).
- Macdown : O Melhor para Mac.
- MarkdownPad : O Melhor para Windows.
- Remarkable : O Melhor para Linux.
- GITBOOK : O GitBook é uma ferramenta de publicação moderna. Facilitando a escrita e a colaboração. Ambos suportam a Markdown e têm uma estreita relação com o amado Github.
Toda a sintaxe pode ser encontrada aqui . Seria necessário muito esforço para descrever a sintaxe no texto (eles serão formatados), então, considere esta tabela abaixo para toda a sintaxe básica.
| Formato | Sintaxe | Exemplo |
|---|---|---|
| Itálico | *Text* | Isto está em itálico |
| Negrito | **Bold** | Isto está em negrito |
| Links inline | [texto](url aqui) | Um link |
| Imagens |  | Uma imagem  |
| Link+imagens | [](url para a pagina)] | Me clique |
| Notas de rodapé | Eu tenho mais [^1] pra dizer. [^1]: diga aqui. | Ei, por favor leia as notas sobre essa tabela. |
| Quebras de linha | Double space + enter | |
| Listas não ordenadas | * Item1 *Item 2 |
|
| Listas Ordenadas | 1. Item a 2. Item b |
|
| Listas mistas | 1. Item 1 * item 1a |
|
| Citação | > Texto citado | Stay Hungry Stay Foolish |
| Preformatted | Comece cada linha com, dois espaços ou mais, faça o look do texto, e x a t a m e n t e, como, você, tipo i, s, t, o. | Comece cada linha com, dois espaços ou mais, faça o look do texto, e x a t a m e n t e, como, você, tipo i, s, t, o. |
| Código | `Insira o código` | cout<<"Hello world"; |
| Bloco de código/ Destaque de Sintaxe | ```Insira o código``` | Ei, leia a nota abaixo desta tabela. |
| Títulos | #, ##, ###, ####, #####, ###### (from h1 to h6) | |
| Riscado | ~ |
|
| Tabelas | | Tables | Are | Cool | |----------|:-------------:|------:| | col 1 is| left-aligned | $1600 | |  |
Nota: **Nota de rodapé** na verdade não é processado corretamente na tabela (e github preview), mas parece ser assim 
O mesmo vale para **Bloco de codigo/Destaque de sintaxe**. É um pouco parecido com essa imagem :
.
Estas características dependem de cada versão de markdown.
-
O Markdown permite que você use escapes de barra invertida para gerar caracteres literais que de outra forma teria um significado especial na sintaxe de formatação da Markdown. Um personagem de escape de barra invertida comumente usado é : \
Assim? \ * Este \ * não é mais itálico, mas é cercado por asteriscos literais. -
Os vídeos do Youtube requerem algum trabalho adicional.
Eles não podem ser adicionados diretamente, mas você pode adicionar uma imagem com um link para o vídeo como este:
<a href="http://www.youtube.com/watch?feature=player_embedded&v=YOUTUBE_VIDEO_ID_HERE
" target="_blank"><img src="http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg"
alt="Texto ALT da imagem aqui" width="240" height="180" border="10" /></a>
- Markdown suporta Emoji 😆 😆 😘 😇 💚 ( obter alguns emojis aqui )
- Você pode usar a tag <br/> para forçar uma quebra de linha.
- O espaço duplo, em seguida, se você quiser fazer uma nova linha se houver problemas para criar novas linhas.
- Ver não é tão bom como praticar. Você pode criar um arquivo de markdown para você praticar ou fazê-lo online aqui.
- As notas de rodapé e o destaque de sintaxe não fazem parte do Markdown original e são apenas suportados por certas versões de markdown (Feedback de Sean Brody)
- Qualquer URL (Como http://www.github.com/) será automaticamente convertido em um link clicável.
- O suporte à tabela Markdown é projetado para lidar com a maioria das tabelas para a maioria das pessoas; não cobre todas as tabelas para todas as pessoas. Se você precisa de tabelas complexas, você precisará criá-las manualmente ou com uma ferramenta especificamente projetada para o formato de saída.
Eu tive tanta dor tornando possível a tabela acima