Markdown: guia para principiantes

O que é markdown

Markdown é uma linguagem de marcação leve: um conjunto de convenções de texto simples que um programa transforma em saída formatada, normalmente HTML. A ideia é que o texto em bruto continue legível — um título marcado com # ou uma lista com hífens parece estruturado antes de ser renderizado. Obtém a clareza da formatação sem sair de um ficheiro de texto nem pegar no rato, por isso escritores e programadores o adotaram tão depressa.

A sintaxe básica

O essencial cabe em poucas linhas. Um # cria um título, e mais cardinais fazem subtítulos menores. Dois asteriscos à volta de um texto põem-no em **negrito**, um em *itálico*. As linhas que começam por - ou * viram marcadores, e as que começam por 1. uma lista numerada. Os links são [texto visível](o-url), e uma imagem igual com um ! à frente. As crases marcam `código`. Domine isso e formata quase tudo.

Porque está em todo o lado

O Markdown espalhou-se porque é portátil e à prova de futuro. É só texto, por isso abre em qualquer editor, copia-se limpo entre apps e continuará legível dentro de décadas. O GitHub usa-o para READMEs e issues, o Reddit e fóruns para publicações, apps de chat como Slack e Discord para formatação de mensagens, e ferramentas de notas e geradores de sites estáticos para documentos inteiros. Aprenda-o uma vez e o mesmo punhado de símbolos funciona em todos.

Truques e variantes

Um par de coisas confundem os principiantes. As linhas em branco importam: os parágrafos precisam de uma linha vazia entre eles, e uma lista muitas vezes precisa de uma antes para renderizar. E markdown não é um padrão único — vem em 'variantes'. As funções básicas funcionam em todo o lado, mas extras como tabelas, listas de tarefas e rasurado são extensões que algumas ferramentas suportam e outras não. Na dúvida, o Markdown do GitHub e a especificação CommonMark são as duas referências mais seguras.

Perguntas frequentes

O que é Markdown?

Uma sintaxe de formatação de texto simples que se converte em HTML com símbolos simples como # e **.

Como ponho texto em negrito em Markdown?

Envolva-o em duplos asteriscos: **assim**.

Onde se usa Markdown?

GitHub, apps de chat, ferramentas de notas, fóruns e geradores de sites estáticos, entre outros.