Como usar Markdown: guia completo para formatar textos com exemplos
O Markdown foi criado para facilitar a produção de conteúdo na web, sendo uma linguagem de marcação leve que permite formatar textos de forma rápida utilizando apenas caracteres de pontuação.
Além da sintaxe simples, ele é compatível com diferentes editores e sistemas operacionais e está presente em serviços como GitHub, ChatGPT, Notion e Obsidian.
Neste guia, veja como o Markdown funciona, conheça os principais comandos, entenda para que eles servem e descubra quais plataformas oferecem suporte à linguagem.
🔎 Windsurf AI: o que é, como funciona e como usar IA para programação
🔔 Canal do TechTudo no WhatsApp: acompanhe as principais notícias, tutoriais e reviews
💡Qwen AI: testamos 10 funcionalidades da IA que você precisa conhecer
Como usar Markdown: confira um guia completo com exemplos de formatação
Reprodução/Freepik/editada
📲 Comparador de celulares do TechTudo: como usar a ferramenta e economizar
📝 Como a inteligência artificial é implementada em chatbots? Saiba no Fórum do TechTudo
Índice
O que é Markdown e para que serve
Como usar Markdown
Principais comandos do Markdown
Como criar listas, tabelas, links, comentários e imagens
Onde usar Markdown
Ferramentas para escrever em Markdown
Dicas para aprender Markdown mais rápido
1.
O que é Markdown e para que serve
Markdown é uma linguagem de marcação leve criada em 2004 pelo blogueiro de tecnologia e designer de interface John Gruber, com contribuições do programador Aaron Swartz.
Seu objetivo era facilitar a leitura, a escrita e a edição de conteúdos para a web.
Na época, quem escrevia para blogs precisava usar HTML ou editores WYSIWYG, que geravam códigos longos e difíceis de editar.
A proposta era permitir que redatores escrevessem em texto simples e legível, sem precisar se preocupar com o HTML.
Editor permite comparar o comando em Markdown com o resultado renderizado
Reprodução/Caroline Silvestre
Para isso, o Markdown também foi lançado como uma ferramenta de software escrita em Perl, que converte textos escritos em Markdown para HTML.
Hoje, além da ferramenta original, existem várias opções para fazer essa conversão.
Ao contrário de programas como Microsoft Word ou Google Docs, em que a formatação é feita por meio de botões e menus, no Markdown ela é inserida diretamente no texto com símbolos.
Entre as principais vantagens da linguagem estão a portabilidade e a compatibilidade, já que os arquivos podem ser abertos em diferentes editores de texto e sistemas operacionais.
O Markdown pode ser usado para criar sites, documentos, anotações, apresentações, e-mails e documentação técnica.
A publicação original em que John Gruber apresentou o Markdown, feita em 2004 em seu blog Daring Fireball, continua disponível para consulta.
IA para transcrever áudio em texto: 9 ferramentas que funcionam bem
2.
Como usar Markdown
A sintaxe do Markdown é composta por caracteres de pontuação, escolhidos para representar diferentes tipos de formatação.
Embora tenha sido influenciada por diversos filtros de texto para HTML já existentes, sua principal inspiração foi o formato de e-mails em texto simples.
Para usar a linguagem, basta adicionar esses caracteres diretamente ao conteúdo.
Por exemplo, para criar um título, coloque o símbolo # antes do texto.
Já para destacar uma palavra ou frase em negrito, adicione dois asteriscos (**) antes e depois do conteúdo.
Da mesma forma, outros símbolos permitem criar listas, inserir links, adicionar imagens e formatar trechos de código.
Depois que o texto é processado por um editor ou plataforma compatível com Markdown, os símbolos são interpretados e a formatação aparece automaticamente.
Nos tópicos a seguir, confira os principais comandos da linguagem e veja como utilizá-los.
Sites para ler light novels online: 4 opções boas para conhecer
3.
Principais comandos do Markdown
Comandos mais usados do Markdown
Como baixar áudio de Reels e Shorts: veja sites que realmente funcionam
4.
Como criar listas, tabelas, links, comentários e imagens
Link
Código em Markdown: [Texto do link](https://www.techtudo.com.br)
Resultado esperado: O texto é exibido como um link clicável que direciona para a página informada.
Ex: Texto do link
Como usar: Coloque o texto que será exibido entre colchetes e o endereço da página entre parênteses.
Imagem
Código em Markdown: 
Resultado esperado: Exibe uma imagem com texto alternativo.
Como usar: Adicione um ponto de exclamação (!), seguido da descrição da imagem entre colchetes e do endereço da imagem entre parênteses.
Tabela simples
Código em Markdown:
| Nome | Idade |
| :--- | :---: |
| Ana | 25 |
| João | 30 |
Resultado esperado: Exibe uma tabela com colunas "Nome" e "Idade".
Como usar: Separe as colunas usando barras verticais (|) e adicione uma linha com hífens (-) para separar o cabeçalho dos dados.
Utilize dois pontos (:) para definir o alinhamento do conteúdo:
Esquerda :---
Centro :---:
Direita ---:
Lista com subitens
Código em Markdown:
- Item principal
[4 espaços] - Subitem
[4 espaços] - Subitem
Resultado esperado: Os subitens são exibidos abaixo do item principal, formando uma lista hierárquica.
Como usar: Use quatro espaços antes do marcador (-) para criar um nível de subitem.
Lista numerada com subitens
Código em Markdown:
1.
Primeiro item
[4 espaços] 1.
Subitem A
[4 espaços] 2.
Subitem B
Resultado esperado: Os subitens são exibidos abaixo do item principal numerado, mantendo a hierarquia da lista.
Como usar: Use quatro espaços antes da numeração para criar um nível de subitem.
Comentário
Código em Markdown:
Resultado esperado: O comentário permanece invisível no conteúdo publicado.
Como usar: Escreva o texto entre .
O recurso depende da plataforma ou do editor utilizado.
5.
Onde usar Markdown
O Markdown pode ser usado em diversas plataformas de desenvolvimento, anotações, inteligência artificial, comunidades online e aplicativos de mensagens.
No entanto, cada serviço pode oferecer suporte apenas a alguns recursos da linguagem.
Confira alguns exemplos:
GitHub: permite criar arquivos README, documentações, wikis, comentários, issues e Pull Requests em projetos.
ChatGPT: permite estruturar prompts e respostas com títulos, listas, tabelas, links e blocos de código.
Claude: aceita Markdown para organizar textos, documentos e conversas.
Notion: oferece suporte ao Markdown na importação de arquivos e em alguns atalhos de formatação.
Obsidian: usa Markdown como formato padrão para criar e organizar notas interligadas.
Visual Studio Code (VS Code): oferece suporte nativo à linguagem, com recursos como visualização em tempo real.
Discord: permite usar recursos básicos de Markdown, como negrito, itálico, listas e citações.
Reddit: utiliza Markdown em publicações e comentários.
Comando em Markdown para criar um título principal no Notion
Reprodução/Caroline Silvestre
Título principal criado no Notion após a renderização do comando em Markdown
Reprodução/Caroline Silvestre
Atalho para limpar cache no Google Chrome: saiba como usar
6.
Ferramentas para escrever em Markdown
Existem diversos editores para escrever em Markdown, desde opções voltadas para programação até ferramentas focadas em produtividade.
Editores de Markdown
Como colocar Google Chrome na área de trabalho: saiba criar atalhos
7.
Dicas para aprender Markdown mais rápido
Aprender Markdown costuma ser fácil, já que a linguagem usa poucos comandos e símbolos simples de memorizar.
Para começar, vale aprender os recursos mais usados no dia a dia, como títulos, negrito, itálico, listas e links.
Depois, conforme a necessidade, é possível avançar para recursos como tabelas e imagens.
Outra dica é usar um editor que mostre o resultado da formatação em tempo real.
Essas ferramentas ajudam a entender como cada comando funciona e tornam o aprendizado mais rápido, sem a necessidade de decorar toda a sintaxe logo no início.
Também é útil manter uma lista com os comandos mais usados para consultar durante a escrita.
A melhor forma de aprender Markdown é praticando.
Criar anotações, escrever documentos ou montar arquivos README são boas maneiras de aplicar os comandos em situações reais.
Além disso, consultar exemplos de outros usuários e a documentação das plataformas compatíveis pode ajudar a descobrir novas formas de organizar os textos.
Com informações de Daring Fireball (1;2), MakeUseOf, Markdown Guide e Web2md.