Tutorial de Markdown - da configuração à sintaxe
Ao mesmo tempo, o Markdown é muito leve e flexível também. O caso de uso mais popular para Markdown é para arquivos de licença e leitura em um repositório do GitHub, mas também está sendo integrado a cada vez mais CMS para gerenciar postagens de blog e até escrever trabalhos de pesquisa. Você pode renderizar equações matemáticas com plugins para látex.
É usado principalmente pelos desenvolvedores, no entanto. É realmente útil para fazer tutoriais e documentação graças ao destaque da sintaxe para vários idiomas e suporte para imagens e até GIFs.
Vamos começar com uma configuração que nos permite visualizar o documento renderizado ao lado de um arquivo de texto em marcação bruta.
Editor de texto Atom e visualização de marcha
Você pode baixar e instalar o editor de texto Atom ou o código do Visual Studio para acompanhar. Código Atom e VS possuem plugins pré-instalados para visualização de marcação. Aqui o Atom será usado, mas a sintaxe permaneceria aproximadamente a mesma, independentemente do editor de texto que você usa.
No Atom, verifique se o pacote de visualização do Markdown está ativado (é, de fato, ativado por padrão). Crie uma pasta para este tutorial de Markdown e, lá, abra um novo arquivo (Ctrl + N) e digite o seguinte texto lá.
# Este é um título___
## este também é um título
Aqui está algum texto
Salve o arquivo (CRTL + s) com um .Extensão do MD. Por exemplo, você pode nomear seu arquivo como teste.md e o .A parte do MD dirá ao Atom que este é um arquivo de remarca e a extensão funcionaria com ele como pretendido. Você pode gerar uma visualização usando o seguinte Keybinding (Ctrl+Shift+M), que é mostrado em um novo painel ao lado do arquivo de texto bruto.
Você pode fechar o painel de visualização usando a mesma ligação à chave ou usando a própria GUI.
Com tudo configurado, podemos dar uma olhada mais de perto na sintaxe e começar a criar documentos incríveis em tempo real.
Sintaxe de Markdown
Como mencionado anteriormente, a principal motivação por trás do Markdown é a legibilidade. Isso significa que não há tags obscuras ou tags aninhadas ou qualquer outra confusão indutora de confusão. Em vez disso, podemos começar com o símbolo '#' para indicar que essa linha específica é um título.
# É um título.## também indica o título, mas com tamanho de fonte menor.
### você pode continuar consecutivamente tamanhos menores
Quebras de linha
Markdown continua a agrupar todo o texto em um parágrafo gigante, mesmo quando o texto bruto é dividido em várias linhas diferentes. Para mitigar isso, você pode usar dois espaços no final de uma linha e depois colocar um personagem de nova linha (ou seja, acertar ) ou apenas use dois caracteres de nova linha para um efeito ligeiramente diferente, como mostrado abaixo.
A frase "é por isso que ..." começou em uma nova linha, mas não é espaçada à parte da linha anterior, enquanto que o uso de duas novas linhas criou uma separação mais ampla.
Regra horizontal
A regra horizontal, como o nome sugere, cria uma linha horizontal que permite estruturar seu documento e fazer separações lógicas nele. Existem dois métodos para criar uma regra horizontal. Primeiro é usar três ou mais sublinhados para criar uma regra horizontal.
#Cabeçallho 1___
O parágrafo e o cabeçalho são separados por uma regra horizontal.
___
Outra seção separada
Outra opção (que não recomendo) é usar três ou mais traços '-', mas eles também são usados para indicar que a frase imediatamente acima deles é um título. Portanto, se você não tiver uma nova linha entre uma frase e a regra horizontal abaixo dela, essa frase assumirá a forma de um título.
Itálico, ousado e atingido
A sintaxe para os três é bastante simples e fala por si.
** Isso está em negrito **__ isso também é ousado
_ Isso é itálico_
*Isso também é itálico*
~~ isso é atingido ~~
Escapar de caráter
Agora, pode -se perguntar: como você literalmente escreveria ** algum texto ** no arquivo final de marcação se ele mudar isso para ousado sempre. Isso é algo com o qual a maioria das linguagens de programação também lida e a solução é semelhante àquelas - use um caractere de barra de barragem. Isso também funciona para outros elementos de sintaxe e não é especificamente para estilo em negrito.
\ ** isso não é mais ousado \ **Se você quiser mostrar o próprio personagem de barragem, use dois deles e assim por diante.
\\ aparece como uma única barra
BlockQuotes e blocos de código
BlockQuotes e blocos de código são muito mais fáceis. Um BlockQuote pode ser usado para destacar um ponto importante para o qual você deseja chamar a atenção dos leitores. Isso pode ser alcançado usando o suporte angular direito no início, como mostrado.
# Cabeçallho 1Lorem ipsum dolor sit amet, consectur adipiscing elit, sed do eiusmod temporal incididunt ut ut
LABORE ET DOLORE MAGNA ALIQUA. Ut Enim ad mínimo Veniam, Quis Nostrud Exercitação Ullamco Laboris
nisi ut aliquiip ex ea commodo consequeat. Duis Aute Irure Dolor em Reprenderit in Voluptate
Velit Esse Cillum dolore eu fugiat nulla pariatur. Exceto Sint Sint Occaecat Cupidatat Non
Proident, Sunt em Culpa Qui Officia Deserunt Mollit Anim Id est Laborum.
> Este é um resumo legal de uma subseção do seu documento. Um> algumas linhas que estão
fora do resto do conteúdo.
O conteúdo continua.
Veja como fica quando é renderizado.
Para blocos de código, simplesmente recue as linhas das linhas em 4 espaços ou mais. Isso é realmente
prático para desenvolvedores e operadores que desejam documentar seu trabalho. Mais tarde veríamos como tornar isso ainda melhor.
Hiperlinks e imagens
Para hiperlinks, a sintaxe é bem simples. O texto visível é escrito entre colchetes e o URL para o qual aponta é escrito em suportes redondos ao lado dele.
Para imagens, a sintaxe é semelhante, exceto que começa com uma marca de exclamação. Você é livre para usar um caminho relativo na pasta do projeto que aponte para a imagem ou você pode ter um URL público.
## ilustrando o hiperlink e a sintaxe da imagem___
Você deve [nos visitar] (https: // linuxhint.com) mais frequentemente
É assim que as imagens são incorporadas.
![SMUGPUG] (https: // upload.Wikimedia.org/wikipedia/commons/d/d2/bonny_bonita.Jpg)
Mesas
Criar tabelas em Markdown inclui literalmente desenhar um retrato ASCII (Unicode para ser preciso).
## tabelas| Coluna 1 | Coluna 2 | Coluna 3 |
| --------- | --------- | --------- |
| Primeira linha | Primeira linha | Primeira linha |
| Segunda linha | Segunda linha | Segunda linha |
A sintaxe não precisa estar exatamente alinhada de uma linha para outra, mas o caractere do tubo é usado para mudar para a próxima coluna e a próxima linha indica que a próxima linha foi iniciada, geralmente.
Marcada estendida
Para aqueles de vocês que chegaram tão longe, aqui está o verdadeiro deleite. Se você estiver usando o Atom, poderá substituir o plug -in de visualização do Markdown para o Markdown Preview Plus. Que oferece as seguintes funcionalidades.
1. Equações matemáticas usando o LATEX:
Você pode realmente inserir scripts de látex entre sinais de dólar e ele será renderizado como script de látex e mostrado na visualização com Ctrl+shitft+x Keybinding. Você nem precisa saber todo o látex, apenas alguns trechos são suficientes.
## ilustrando látex___
$$ | \ psi \ rangle = \ alpha | 0 \ rangle + \ beta | \ Rangle $$
2. Realce de sintaxe
Em vez de usar o recuo para indicar blocos de código, você pode realmente usar backticks seguidos pelo nome dos idiomas em que seu script é supostamente escrito. Os idiomas cuja sintaxe são suportados são numerosos demais para listar aqui, mas aqui está um exemplo no Python.
## ilustrando o destaque da sintaxe___
"Pitão
importar isso
def my_function ():
print ("Olá, mundo!")
retornar 0
"
Existem muitos sabores ou markdown. O GitHub tem sua própria bebida especial e a sintaxe é muito flexível. Isso não deve intimidar os usuários, mas atender a uma variedade mais ampla deles. É um daqueles idiomas que apenas se entende um subconjunto que se precisa e o usa, em vez de se incomodar com os detalhes técnicos (a menos que você esteja interessado em seus detalhes técnicos!)