O que é um arquivo .md e como ler Markdown

Um arquivo .md é um arquivo de texto escrito em Markdown. Ele usa símbolos simples para indicar títulos, listas, links, negrito, código e outros elementos. Como o conteúdo é texto, pode ser aberto em muitos programas; como contém estrutura, fica mais fácil de ler em um visualizador Markdown.

Markdown explicado sem complicação

Markdown não é um formato fechado como um documento de processador de texto. É uma maneira compacta de escrever estrutura usando caracteres comuns do teclado. O texto continua legível mesmo quando você abre o arquivo no Bloco de Notas.

Veja um exemplo:

# Minha receita

## Ingredientes

- 2 tomates
- 1 cebola

**Tempo:** 20 minutos

Um visualizador interpreta o primeiro # como título, ## como subtítulo, os hífens como lista e os asteriscos como negrito.

Onde os arquivos .md aparecem

Você pode encontrar Markdown em muitos lugares:

• README.md de projetos no GitHub e GitLab;
• notas e documentos no Obsidian;
• páginas exportadas ou escritas em ferramentas como Notion;
• wikis, blogs e sistemas de documentação;
• arquivos gerados por ChatGPT, Claude e outras ferramentas de IA;
• rascunhos pessoais que precisam continuar em texto simples.

O arquivo não depende do site onde foi criado. Um README pode ser lido no repositório, em um editor local ou no navegador.

Como ler um .md

Há duas formas principais. A primeira é abrir como texto puro: você vê as marcas exatamente como foram escritas. A segunda é usar um renderizador Markdown: títulos, listas, tabelas, links e blocos de código aparecem com formatação.

Para abrir sem instalar nada, use o Sanctuary Reader. Você pode carregar o arquivo, arrastá-lo, colar o conteúdo ou informar uma URL pública.

Como escrever o básico

# Título
## Seção
[um link](https://exemplo.com)
**negrito** e *itálico*
- item
1. primeiro passo

Comece com títulos e listas. Depois, adicione links, citações, tabelas e blocos de código conforme a necessidade. Um arquivo bem dividido por títulos também ganha um índice mais útil no visualizador.

Markdown não é HTML

Markdown pode ser convertido para HTML, mas os dois formatos não são a mesma coisa. No Markdown, você escreve ## Seção; no HTML, escreveria uma tag como <h2>Seção</h2>. O renderizador faz essa transformação para você.

O resultado depende do dialeto usado. GitHub, editores locais e visualizadores podem oferecer extensões diferentes. Por isso, sempre confira o arquivo na ferramenta onde ele será publicado.

Próximos passos

Consulte a futura seção de referência de sintaxe Markdown para exemplos lado a lado. Se a dúvida é abrir um arquivo específico, siga o guia para abrir .md no navegador.

Abrir este exemplo no Sanctuary Reader e ver renderizado →