O que é markdown? Veja como usar no Notion, GitHub, Obsidian e Reddit

Você já ouviu falar em Markdown, mas não sabe exatamente para que serve? Essa linguagem simples transforma textos comuns em conteúdos formatados, prontos para a web e diversos apps — e você pode usá-la em várias ferramentas, principalmente no Notion, GitHub, Obsidian e Reddit.

• 5 linguagens ideais para quem está começando a programar
• Quais são as linguagens de programação mais populares do GitHub

A seguir, confira:

• O que é Markdown e para que ele serve?
• Quais são as principais regras de sintaxe do Markdown?
• Como usar Markdown no GitHub?
• Como o Notion interpreta comandos de Markdown?
• Como o Obsidian aproveita o Markdown para organização de notas?
• Como o Markdown pode ser usado no Reddit?

O que é Markdown e para que ele serve?

Markdown é uma linguagem de marcação criada para converter textos simples em linguagem HTML. Ela permite aplicar formatações, como negrito, itálico, títulos e listas de forma fácil, sem precisar escrever HTML diretamente.

–
Entre no Canal do WhatsApp do Canaltech e fique por dentro das últimas notícias sobre tecnologia, lançamentos, dicas e tutoriais incríveis.
–

Assim, o Markdown serve para:

• Escrever textos com formatação de forma rápida e limpa, sem depender de editores gráficos;
• Converter textos para HTML automaticamente, o que é útil para blogs, sites, documentações técnicas etc.;
• Facilitar a escrita em apps de programação ou colaboração online, como GitHub, Reddit, Notion, Obsidian etc.

Quais são as principais regras de sintaxe do Markdown?

As sintaxes do Markdown são os símbolos e regras usados para aplicar formatações em um texto comum, como deixar palavras em negrito, criar listas, inserir links, entre outros.

Títulos

Para os títulos, é necessário usar o símbolo # no início da linha. Quanto mais #, menor será o título — contudo, a formatação é limitada a seis tamanhos. Por exemplo:

• # Título 1
• ## Título 2
• ### Título 3

Negrito, itálico e riscado

Quando quiser incluir negrito e itálico no conteúdo, deve-se usar asteriscos ou underline:

• Negrito: **texto** ou __texto__
• Itálico: *texto* ou _texto_
• Negrito e itálico: ***texto***
• Riscado: ~texto~

Listas

No caso de listas com marcadores, como bullet points, use os símbolos de adição (+), subtração (-) ou asterisco (*). O resultado final de todos será o mesmo.

Já para listas com números, basta incluir os números com ponto final:

• 1. Exemplo
• 2. Exemplo

Links

Se você quiser adicionar links, escreva o texto entre colchetes e inclua a URL entre parênteses, como no exemplo abaixo:

• [texto do link](https://canaltech.com.br)
• [Canaltech](https://canaltech.com.br/) 

Imagens

Em relação às imagens, é necessário colocar um ponto de exclamação antes da descrição e da URL da mídia.

•  

Citações

Para incluir citações, use o símbolo > antes do texto.

• > Um exemplo de citação.

Blocos de código

Para inline, insira uma crase (`) para destacar um trecho curto de código no meio do texto. Exemplo: `print()`

No caso de blocos, use três crases (“`) antes e depois do código.

Tabela

Nas tabelas, use o símbolo pipe (|) para separar colunas e traço (-) para criar a linha de separação do cabeçalho. Para alinhar o texto, utilize dois pontos (:): 

• :— (alinha o texto à esquerda)
• :—: (alinha o texto ao centro)
• —: (alinha o texto à direita)

Veja o exemplo:

| Nome   | Idade | Cidade       |

|——–|:—–:|————-:|

| Joana   |  25   | São Paulo    |

| Júlia |  30   | Rio de Janeiro |

Como usar Markdown no GitHub?

Para usar Markdown no GitHub, basta:

1. Criar ou editar um arquivo .md;
2. Usar Markdown para formatar textos em README, comentários, commits, wikis e documentos da plataforma.
3. Visualizar a prévia para conferir o resultado;
4. Salvar o trabalho para o GitHub converter automaticamente o Markdown para HTML.

Como o Notion interpreta comandos de Markdown?

O Notion é um editor visual por blocos, e não “Markdown puro”, como o Obsidian e GitHub. No entanto, ele reconhece parte da sintaxe Markdown enquanto você digita e converte automaticamente para blocos formatados. Assim, você não vê o Markdown “cru” (**texto**).

Além disso, nem todos os recursos de Markdown são suportados no Notion, como em links, imagens e tabelas.

As sintaxes reconhecidas pelo editor são: negrito, itálico, código inline, texto riscado, lista com marcadores, tarefas e numeradas, e títulos (H1, H2, H3).

Como o Obsidian aproveita o Markdown para organização de notas?

O Obsidian usa o Markdown para criar e organizar notas em arquivos de texto simples (.md). Com ele, é possível usar títulos, listas, blocos de código e links entre notas ([[nome da nota]]) para estruturar e conectar ideias.

Além disso, o Obsidian amplia o Markdown com recursos extras, como callouts, tarefas, notas de rodapé e visualização em gráfico, para transformar suas anotações em um sistema inteligente e interligado.

Como o Markdown pode ser usado no Reddit?

O Reddit utiliza uma versão personalizada do Markdown para formatação de posts, comentários, wikis e outras áreas, que proporciona maior controle do usuário sobre a aparência do conteúdo.

O Reddit suporta as sintaxes: negrito, itálico, riscado, citação (blockquote), lista não ordenada e ordenada, links, código inline, bloco de código e quebra de linha.

Confira também:

• 3 tendências de desenvolvimento de software para 2025, segundo o GitHub
• 4 dicas do GitHub para quem quer aprender a programar
• Trello, Notion e mais: 7 apps para aumentar a produtividade

VÍDEO: Celular de 20 MIL? O que tá ACONTECENDO com os PREÇOS dos celulares CHINESES no Brasil?

Leia a matéria no Canaltech.