Phenquestions
O Markdown padrão
Markdown é um padrão desenvolvido por John Gruber. O principal objetivo do Markdown é tornar o arquivo possível de ler, mesmo em texto puro. Se você quiser olhar em um editor apenas de texto, você deve ter um tempo fácil de lê-lo. Isso é muito útil para usuários de vim e similares. Observe e lembre-se de que este é um padrão para alterar arquivos de texto. Não está substituindo o HTML. Em vez disso, você o usa para criar HTML onde for útil. No caso do GitHub, eles formatarão o arquivo Leiame no site. Contanto que você siga o padrão, pode ter certeza de que terá uma boa aparência.
Como o GitHub adicionou apenas algumas extensões, você deve começar usando uma folha de referências do Markdown e partir daí. Aqui está uma lista dos mais comuns.
| Markdown | Extensões | Resultado |
| # (1 por nível) | Títulos | |
| * | Itálico | |
| ** | Negrito | |
| > | Bloco de citação | |
| 1. (etc.) | Lista Ordenada | |
| - | Lista não ordenada | |
| 'código' | Seu código | |
| “' | Md-ext | Iniciar e terminar um bloco de código |
| - | Regra Horizontal | |
| [Descrição] (https: // www.exemplo.com) | Um nome em quadrado e URL entre colchetes regulares | |
| ![texto alternativo] (imagem.png) | Mesmo, link para uma imagem | |
| [1] | Md-ext | Uma nota de rodapé |
As listas podem ser aninhadas recuando quaisquer itens que você deseja aninhar.
Outras extensões do Markdown regular, você tem as extensões de blocos de código acima. Eles nem sempre são suportados por serviços.
| Markdown | Extensões | Resultado |
| ### Título # custom-id | Md-ext | Um título que você pode endereçar por seu ID |
| termo: definição | Md-ext | Uma lista de termos com definições |
| ~ Texto errado ~ | Md-ext | Texto tachado |
| - [x] Tarefa a fazer | Md-ext | Uma lista de tarefas que você pode marcar |
A tabela é muito simples, mas você precisa de várias linhas para mostrá-la: Tabela:
| Nome VALOR || ----------- | ---------- |
| Tapetes | 100
Extensões GitHub.
O GitHub adicionou algumas extensões para tornar mais simples lidar com links para outras pessoas e projetos. Algumas dessas são as tabelas mencionadas anteriormente. O que mais o ajudará é a extensão de link automático. Ele cria um link sozinho quando você o usa no GitHub.
Outros são tabelas e itens da lista de tarefas. Eles são convenientes para manter o controle de suas tarefas em projetos. O último a ser mencionado é a extensão Disallowed Raw HTML. Com a ajuda desta extensão, algumas tags são filtradas ao renderizar para HTML. Essas tags podem causar efeitos estranhos ao renderizar para o GitHub.
Maneiras de explorar o GitHub Markdown
Se achar isso confuso, você também pode ir para a página do GitHub e usar o editor integrado. Ao usá-lo, ele completará automaticamente algumas funções. Isso só funciona para problemas, mas você pode usá-lo para descobrir algumas coisas, os emojis aparecem como uma lista quando você digita dois pontos (:).
Você também pode encontrar um projeto no GitHub que tenha um arquivo README de excelente aparência e cloná-lo em sua unidade local. A partir daí, você pode explorar o arquivo usando qualquer editor que desejar. Para os grandes editores, Emacs e Vim, há suporte para markdown por meio de extensões.
Se você estiver usando o vim, você pode colocar uma extensão de realce de sintaxe do GitHub, vim-markdown. Esta extensão mostra que você fez o código corretamente. Para ajudá-lo a ver como ficará quando terminar, você também pode obter a extensão da marca ao vivo. Com isso, você pode ter um servidor web rodando, mostrando o resultado ao vivo enquanto você digita.
Com o Emacs, você tem modo impaciente, modo inativo ao vivo e visualização em tempo real. Todos eles mostram a página resultante em um navegador enquanto você digita. O primeiro requer menos bibliotecas do que o último, mas precisa de um snippet de código extra para ser executado.
Conclusão
Mesmo que o markdown seja uma especificação pequena e deliberadamente simples, pode ser um pouco confuso para começar. A melhor maneira de aprender é usar uma folha de dicas e escrever seu documento Markdown. Você pode atualizar seu README.md no GitHub, e você pode obter muito suporte das funções integradas de seus editores. Como uma observação lateral, o GitHub também suporta emojis que você pode adicionar ao seu documento. Você pode usar a folha de dicas para descobrir quais são eles.
Baixe Markdown-CheatSheetHere
