Phenquestions
Ao mesmo tempo, a redução é muito leve e flexível também. O caso de uso mais popular para markdown é para arquivos de licença e README em um repositório GitHub, mas também está sendo integrado a cada vez mais CMS para gerenciar postagens de blog e até mesmo escrever artigos de pesquisa. Você pode renderizar equações matemáticas com plug-ins para LaTeX.
É usado principalmente por desenvolvedores, no entanto. É realmente útil para fazer tutoriais e documentação, graças ao destaque de sintaxe para vários idiomas e suporte para imagens e até mesmo gifs.
Vamos começar com uma configuração que nos permite visualizar o documento renderizado ao lado de um arquivo de texto markdown bruto.
Editor de Texto Atom e Visualização de Markdown
Você pode baixar e instalar o Atom Text Editor ou Visual Studio Code para acompanhar. O Atom e o VS Code têm plugins pré-instalados para Markdown Preview. Aqui o Atom será usado, mas a sintaxe permanecerá praticamente a mesma, não importa qual editor de texto você use.
No Atom, certifique-se de que o pacote de visualização do Markdown esteja ativado (na verdade, ele está 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 md. Por exemplo, você pode nomear seu arquivo como teste.md e o .a parte md dirá ao Atom que este é um arquivo markdown e a extensão funcionará com ele como pretendido. Você pode gerar uma visualização usando o seguinte atalho de tecla (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 tecla de atalho ou usando a própria GUI.
Com tudo configurado, podemos dar uma olhada na sintaxe e começar a criar documentos incríveis na hora.
Sintaxe Markdown
Conforme 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 sequência de indução de confusão. Em vez disso, podemos começar com o símbolo '#' para indicar que essa linha em particular é um título.
# É um título.## Também indica o título, mas com tamanho de fonte menor.
### Você pode ir para tamanhos consecutivamente menores
Quebras de linha
Markdown continua agrupando todo o texto em um parágrafo gigante, mesmo quando o texto bruto é dividido em várias linhas diferentes. Para atenuar isso, você pode usar dois espaços no final de uma linha e, em seguida, colocar um caractere de nova linha (ou seja, pressione
A frase "É por isso que ..." começou em uma nova linha, mas não está separada da linha anterior, enquanto o uso de duas novas linhas criou uma separação mais ampla.
Regra Horizontal
A régua 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 régua horizontal. Primeiro é usar três ou mais sublinhados para criar uma régua horizontal.
#Cabeçallho 1___
O parágrafo e o título são separados por uma régua horizontal.
___
Outra seção separada
Outra opção (que não recomendo) é usar três ou mais travessões '-' mas 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 linha horizontal abaixo dela, essa frase terá a forma de um título.
Itálico, negrito e tachado
A sintaxe para os três é bastante simples e fala por si.
** Isso está em negrito **__Isto também é negrito__
_Isto é itálico_
* Isso também é itálico *
~~ Isso é tachado ~~
Personagem de fuga
Agora, alguém pode perguntar, como você escreveria literalmente ** algum texto ** no arquivo de marcação final se ele apenas mudasse para negrito todas as vezes. Isso é algo com que muitas linguagens de programação também lidam e a solução é semelhante a essas - use um caractere de barra invertida. Isso funciona para outros elementos de sintaxe também, e não é especificamente para estilos em negrito.
\ ** Isso não é mais negrito \ **Se você quiser mostrar o próprio caractere de barra invertida, 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. Uma citação pode ser usada para destacar um ponto importante para o qual você deseja chamar a atenção dos leitores. Isso pode ser conseguido usando o suporte angular direito no início, conforme mostrado.
# Cabeçallho 1Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
nisi ut aliquip ex e a commodo consequat. Duis aute irure dolor em repreender, em volúpia
velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
> Este é um belo resumo de uma subseção do seu documento. Algumas linhas que se mantêm
fora do resto do conteúdo.
O conteúdo continua.
É assim que fica quando é renderizado.
Para blocos de código, simplesmente indente as linhas das linhas em 4 espaços ou mais. Isso é realmente
útil para desenvolvedores e operadores que desejam documentar seu trabalho. Mais tarde veríamos como tornar isso ainda melhor.
HyperLinks e imagens
Para hiperlinks, a sintaxe é muito simples. O texto visível está escrito entre colchetes e o URL para o qual ele aponta está escrito entre colchetes ao lado dele.
Para imagens, a sintaxe é semelhante, exceto que começa com um ponto de exclamação. Você é livre para usar um caminho relativo na pasta do seu projeto que aponta para a imagem ou você pode ter um URL público.
## Ilustrando HyperLink e sintaxe de imagem___
Você deve [nos visitar] (https: // linuxhint.com) com mais frequência
É 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) de uma tabela.
## Tabelas| Coluna 1 | Coluna 2 | Coluna 3 |
| --------- | --------- | --------- |
| Primeira linha | Primeira linha | Primeira linha |
| Segunda linha | Segunda linha | Segunda linha |
A sintaxe não precisa ser exatamente alinhada de uma linha para outra, mas a barra vertical é usada para alternar para a próxima coluna e a próxima linha indica que a próxima linha começou, geralmente.
Markdown estendido
Para aqueles de vocês que vieram até agora, aqui está o verdadeiro mimo. Se estiver usando o Atom, você pode substituir o plug-in Markdown Preview pelo Markdown Preview Plus. Que oferece as seguintes funcionalidades.
1. Equações matemáticas usando LaTeX:
Você pode inserir scripts LaTeX entre os cifrões e será renderizado como script LaTeX e mostrado na visualização com CTRL + SHITFT + X keybinding. Você nem precisa saber tudo sobre o LaTeX, apenas alguns trechos são suficientes.
## Ilustrando LaTex___
$$ | \ Psi \ rangle = \ alpha | 0 \ rangle + \ beta | \ rangle $$
2. Realce de sintaxe
Em vez de usar indentação para indicar blocos de código, você pode usar crases seguidos do nome das linguagens em que seu script foi supostamente escrito. As linguagens cuja sintaxe é suportada são numerosas demais para listar aqui, mas aqui está um exemplo em python.
## Ilustrando o destaque de sintaxe___
"Pitão
importe isso
def my_function ():
print ("Olá, Mundo!")
retornar 0
"
Existem muitos sabores ou Markdown. GitHub tem sua própria mistura especial e a sintaxe é muito flexível. Isso não deve intimidar os usuários, mas atender a uma variedade maior deles. É uma daquelas linguagens em que apenas se entende um subconjunto de que precisamos e o usa, em vez de nos incomodarmos com os detalhes técnicos (a menos que você esteja interessado em seus detalhes técnicos!)
