O que é Markdown? Um guia para iniciantes para começar

Se você escreve muito para a web, deve aprender Markdown. É uma linguagem de marcação simples que permite formatar texto facilmente sem se preocupar com a maioria dos processadores de texto completos.

Vamos dar uma olhada no que é Markdown, por que ele é útil e como começar a usá-lo.

O que é Markdown?

Markdown é uma linguagem de marcação usada para criar texto formatado, normalmente para publicação na Internet. Se você não estiver familiarizado, uma linguagem de marcação se refere a um sistema que inclui elementos de sintaxe que ajustam a aparência, mas não aparecem no documento final.

Por exemplo, quando você escreve "** texto em negrito **" em um documento Markdown, ele aparecerá como " texto em negrito ".

HTML, que é uma parte essencial da web, também é uma linguagem de marcação. No entanto, Markdown se distingue de linguagens de marcação como essas por ser considerada uma linguagem leve.

É fácil olhar para um documento Markdown e ainda ler o que o texto diz. No entanto, com linguagens "pesadas" como HTML, não é tão fácil para uma pessoa processar o que o texto diz – o que significa que não é ideal para escrever.

Leia mais: Compreendendo o código HTML básico

O Markdown também oferece uma alternativa à escrita em processadores de texto como Microsoft Word ou Pages. Esses editores fornecem uma tonelada de opções para formatar seu texto, mas podem perder tempo se você tiver que percorrer os menus apenas para encontrar a lista com marcadores ou opção de cabeçalho.

O texto fortemente formatado dos processadores de texto também pode ser mal traduzido para HTML, o que resulta em trabalho extra para limpar o código confuso. E os processadores de texto geralmente salvam em um formato proprietário, o que pode ser um problema se você parar de usar esse software no futuro.

Com o Markdown, você pode trabalhar em texto simples para escrever artigos que sejam facilmente lidos por humanos. É trivial exportar seus documentos Markdown para HTML para publicação online. E como o Markdown funciona em qualquer lugar, você não precisa usar ou pagar por um software específico.

Sabores de Markdown

Markdown não é um padrão concreto. Embora os princípios básicos sejam bastante consistentes em todos os lugares em que é usado, existem algumas diferenças dependendo do serviço ou aplicativo que você usa para escrever o Markdown.

Por exemplo, GitHub Flavored Markdown oferece suporte a tabelas. Outro padrão, MultiMarkdown, adiciona recursos adicionais como notas de rodapé e citações. E há muitas outras edições que você pode encontrar.

Infelizmente, não é possível cobrir todas as iterações do Markdown. Você terá que aprender os detalhes de como o editor ou serviço escolhido funciona. No entanto, não se preocupe com isso ainda; você pode aprender mais sobre um tipo específico de Markdown depois de aprender os fundamentos.

Usando Markdown: Formatação Essencial

Vejamos alguns dos métodos de formatação de texto mais comuns no Markdown. Observe que eles podem diferir ligeiramente dependendo do tipo de Markdown que você está usando.

Itálico e Texto em Negrito

Você pode colocar o texto em itálico envolvendo-o em um asterisco. Use asteriscos duplos para colocar o texto em negrito. Se preferir, você pode substituir os asteriscos por sublinhados.

Então o seguinte:

 *italic text here* | __bold text there__

Será mostrado como:

texto em itálico aqui | texto em negrito lá

Títulos

Os cabeçalhos HTML, como os usados ​​neste guia, são uma maneira comum de organizar a estrutura de um documento. O Markdown simplesmente usa símbolos hash para corresponder à profundidade do título (de h1 a h6 ). Portanto, para um título h2 , você usa dois hashes e assim por diante.

Por exemplo, o seguinte snippet de Markdown:

 ## This Is Heading 2
Here's some text under the H2 heading. Next, we'll have an H3.
### Here's Heading 3
More text here!

Aparecerá da seguinte forma:

Leia mais: Folha de referências do HTML Essentials

Listas com marcadores e numeradas

É fácil criar listas não ordenadas e ordenadas no Markdown. Para uma lista não ordenada (marcadores), use asteriscos ou hifens, como:

 * A
* B
...
- Y
- Z

Isso aparecerá como:

  • UMA
  • B

  • Y
  • Z

Para uma lista ordenada (numerada), basta digitar o número 1 seguido por um ponto, da seguinte forma:

 1. First item
2. Second item

O acima resulta em:

  1. Primeiro item
  2. Segundo item

Adicionar links no Markdown também é fácil; ele usa uma combinação de colchetes para o texto âncora e parênteses para a URL. Aqui está um exemplo:

 [website link here](https://tecnoguia.istocks.club/)

Isso se traduzirá em um hiperlink normal, assim:

link do site aqui

Imagens

Você pode adicionar imagens no Markdown da mesma forma que adiciona hiperlinks. Comece com um ponto de exclamação. Depois disso, coloque os colchetes contendo o texto alternativo da imagem (que é opcional) e, por fim, coloque o URL da imagem entre parênteses.

Por exemplo:

 ![WhatsApp to Telegram](https://static0.makeuseofimages.com/wordpress/wp-content/uploads/2021/01/How-to-Move-WhatsApp-Chats-History-to-Telegram.png)

Vai resultar em:

Cotações e blocos de código

Para uma citação em bloco, anteceda o texto com um símbolo de maior que. Veja como isso parece:

 > "I think that computers are awesome!"

O texto resultante é:

"Eu acho que os computadores são fantásticos!"

Se você quiser usar um bloco de código pré-formatado para preservar o texto como ele aparece, use a marca de acento grave (acima da tecla Tab em seu teclado) assim:

 `See how the **Markdown** formatting *doesn't* apply in a code block?`

Isto resulta em:

 See how the **Markdown** formatting *doesn't* apply in a code block?

Caracteres de escape e tags embutidas

Às vezes, os caracteres de formatação do Markdown podem interferir no que você está tentando escrever. Por exemplo, você pode querer escrever "* sério *" e realmente mostrar os asteriscos.

Nesses casos, você precisa usar uma barra invertida, que é conhecida como caractere de escape . Colocar uma barra invertida atrás de um caractere fará com que o Markdown o mostre em vez de interpretá-lo como formatação. Aqui está uma ilustração:

 - This is *seriously* good work.
- This is *seriously* good work.

Será mostrado como:

  • Este é um trabalho realmente bom.
  • Este é * sério * um bom trabalho.

Se houver algo que você deseja escrever no Markdown e não consegue encontrar a sintaxe, você sempre pode usar tags HTML no texto do Markdown. Por exemplo, Markdown não tem formatação para sublinhar, uma vez que não é muito usada na web hoje. Se, por algum motivo, você ainda quiser sublinhar o texto, poderá usar:

 This is an <u>underlined</u> word.

E você obteria:

Esta é uma palavra sublinhada .

Se precisar de mais ajuda sobre o Markdown , o Markdown Guide é um excelente recurso.

Editores Markdown facilitam a escrita

Agora que vimos os fundamentos do Markdown, como você realmente começa a escrever nele? Como o Markdown é apenas um texto simples, você pode escrevê-lo em qualquer editor de texto, como o Bloco de notas. Salve um arquivo com a extensão .MD para fazer um arquivo Markdown apropriado.

No entanto, para obter a melhor experiência, você deve usar um aplicativo de escrita desenvolvido para Markdown. Isso inclui recursos como atalhos de teclado, temas personalizáveis ​​e um painel de visualização para que você possa ver exatamente como seu documento ficará na web. É importante ressaltar que os editores Markdown também permitem que você exporte seu documento Markdown como HTML para facilitar a exportação.

Se você está apenas começando com o Markdown, tente primeiro um dos melhores editores online do Markdown . Quando você estiver pronto para experimentar um editor Markdown de área de trabalho, veja por que o Typora pode ser o melhor editor Markdown que existe .

Mesmo se você não for um escritor, Markdown também é útil em muitos outros lugares. É comum em ambientes de programação como GitHub, onde é usado para formatar arquivos Leia-me contendo instruções. Ele também é usado em muitos aplicativos de mensagens e fóruns, incluindo Slack, Telegram e Reddit.

Master Markdown para escrever online

Se você escreve para a web com frequência, vale a pena aprender Markdown. É usado em todos os lugares, não está vinculado a um aplicativo específico, exporta de forma limpa para HTML e é fácil de ler. Os editores específicos do Markdown incluem tudo que você precisa e retiram o que você não precisa, tornando-os mais adequados para esse tipo de escrita do que os processadores de texto.

Eu usei Markdown para escrever artigos MUO por anos e não consigo imaginar usar qualquer outra coisa. Para ajudá-lo em seu caminho, por que não usar nossa folha de dicas para impressão do Markdown como referência?