Markdown

Estudos sobre Markdown acompanhando os vídeos do curso de Git & GitHub do site CursoemVideo

Markdown Simples

Vamos começar com algumas formatações básicas

Itálico

Para colocar uma palavra em itálico, podemos colocá-la entre asteriscos simples ou entre underlines simples

Negrito

Para usar o negrito, basta colocar asteriscos duplos ou underlines duplos para delimitar o termo

Riscado (strike)

Para riscar um texto, coloque-o entre dois símbolos de til

Listas

Listas Numeradas

Para criar uma lista numerada, comece a linha com um número qualquer, seguido de um ponto. O primeiro número da lista vai indicar onde ela começa, os itens seguintes, se estiverem em linhas consecutivas, vão continuar a sequência

Listas com Numeradores

Basta usar um asterisco seguido de um espaço ou um traço seguido de espaço no início de uma linha para que ele seja parte de uma lista demarcada

Lista de Tarefas

Colocando um sinal - [ ] ou - [x] antes de cada item, criamos listas de tarefa com itens marcados ou desmarcados

Títulos e linhas horizontais

Títulos

Para criar títulos, podemos usar de uma # até seis ###### para definir o nível do título para que o conteúdo fique organizado corretamente

Linhas Horizontais

Para criar linhas horizontais, podemos usar três traços --- ou três asteriscos ***

Imagens

Imagens

Para inserir uma imagem, vamos usar o símbolo ![ ]( ) onde a descrição fica entre colchetes e o endereço da imagem entre parênteses

Trechos de Código

Como o GitHub é uma rede social para programadores, nada mais interessante do que aprendermos a demarcar nossos códigos e comandos

Comando Isolado

Se for citar um comando apenas, basta colocá-lo entre crases

Trecho de Código

Para compartilhar um código com mais linhas, basta colocar todas elas dentro de um grupo delimitado entre três crases consecutivas (sem espaço entre elas)

Ligações entre Conteúdos

Quando criamos conteúdos em Markdown para o GitHub, podemos relacionar conteúdos com outros ou com pessoas usando essas marcas

Citação

Ao responder alguém, podemos realizar citações a outras mensagens completas ou a trechos dela, usando sinais de > no início da linha

Menções a Usuários

Se você precisar mencionar algum usuário, pode indicar o nome do perfil logo após o símbolo de @

Menções a Issues

Também podemos mencionar Issues e Pull Requests de nosso repositório usando o símbolo de # seguido do número do elemento (sem espaços)

Símbolos

Escapando Símbolos

Até o momento, vimos que temos vários símbolos que servem para criar formatações. Mas e se por acaso quisermos mostrar exatamente o símbolo sem seu efeito de formatação? A resposta é simples: usamos uma barra invertida \ antes do símbolo para eliminar o efeito de formatação

Emojis

Existem códigos especiais para emojis em Markdown, que devem ser representados entre símbolos de ::

Tabelas

Tabelas

Para criar tabelas em markdown é extremamente simples. Basta usar as barras em pé (pipes) | e as barras deitadas (traços) - de forma organizada