O que é um arquivo .md? Uma explicação simples

Um arquivo .md é um documento de texto comum escrito em um estilo chamado Markdown. Os símbolos que aparecem nele, como #, **, - e |, são instruções sobre a aparência do texto: esta linha é um título, esta palavra está em negrito, estas linhas formam uma lista. Um app que entende Markdown esconde os símbolos e mostra a formatação. Um app que não entende, como o Editor de Texto, mostra os próprios símbolos.

Markdown em um parágrafo

A maioria dos documentos que você conhece, como arquivos do Word e PDFs, guarda a formatação em uma camada oculta que você nunca vê. O Markdown faz o contrário: a formatação fica escrita no próprio texto, com caracteres comuns do teclado. O arquivo é só texto, então qualquer computador consegue abri-lo, ele quase não ocupa espaço e continuará legível daqui a trinta anos. O preço é precisar de um app que leia os símbolos e os transforme em formatação; sem isso, você os vê crus.

Quem inventou, e por quê

O Markdown foi criado por John Gruber, autor do blog Daring Fireball, e lançado em 2004, com muita ajuda do programador Aaron Swartz. Gruber queria um jeito de escrever para a web sem digitar HTML, e colocou uma regra acima das outras: um documento Markdown deve ser legível como está, em texto puro, sem parecer coberto de instruções de formatação.

Por isso os símbolos foram emprestados de hábitos que as pessoas já tinham em e-mails de texto puro, como asteriscos em volta de uma palavra para dar ênfase. É por isso que um arquivo .md cru, com toda a sua bagunça, ainda é em boa parte legível.

Outras pessoas acrescentaram depois o que faltava no original. A versão mais usada hoje é o GitHub Flavored Markdown, que trouxe tabelas, listas de tarefas e texto tachado. Quando alguém diz “Markdown” hoje, geralmente está falando dela.

Por que as IAs escrevem em Markdown

Quando o ChatGPT, o Claude, o Gemini ou o Copilot responde, o texto que ele escreve costuma ser Markdown. Você raramente percebe, porque a janela do chat transforma os símbolos em títulos, negrito e tabelas antes de você vê-los. O formato combina com essas ferramentas: é compacto, sobrevive à cópia entre apps e é comum no tipo de texto técnico com que elas aprenderam.

O problema começa quando a resposta sai do chat. Peça “um arquivo” e você recebe um .md: o mesmo texto, com símbolos e tudo, sem nada para convertê-los. Copie uma resposta para um app que não entende Markdown e os asteriscos vêm junto.

O que os símbolos significam

Estes são os que você vai encontrar em quase todo documento escrito por IA.

O que você vê no arquivo	O que significa
`# Título`	O título principal
`## Seção`, `### Subseção`	Títulos menores: quanto mais `#`, menor o título
`importante`	Negrito: importante
`nota` ou `_nota_`	Itálico: nota
`- item` ou `* item`	Uma lista com marcadores
`1. item`	Uma lista numerada
`- [ ] tarefa` e `- [x] feito`	Uma lista de tarefas: uma caixa vazia e uma marcada
`[o relatório](https://example.com)`	Um link: as palavras entre colchetes, o endereço entre parênteses
`> texto citado`	Uma citação, mostrada com recuo
`código`	Um termo técnico ou trecho de código, em fonte de máquina de escrever
Três crases em uma linha só para elas	O começo ou o fim de um bloco de código
Linhas de palavras separadas por barras verticais	Uma tabela (veja abaixo)

As tabelas são o que mais assusta em forma crua, então aqui vai uma:

| Item | Preço  |
| ---- | ------ |
| Café | R$ 8   |
| Bolo | R$ 12  |

A primeira linha é o cabeçalho, a linha de traços o separa do resto e cada linha seguinte é uma linha da tabela. As barras marcam onde termina uma coluna e começa a próxima. Exibida do jeito certo, é uma tabela pequena e comum, com duas colunas e duas linhas.

Alguns outros aparecem de vez em quando: ~~texto~~ para tachado, --- em uma linha só para ele como linha divisória e ![descrição](imagem.png) para uma imagem. Isso cobre quase tudo.

Por que o Mac mostra os símbolos

O macOS não tem um leitor de Markdown embutido. Para o sistema, um arquivo .md é texto puro, então o clique duplo abre o app que cuida de texto puro, normalmente o Editor de Texto, ou o Xcode se as ferramentas de desenvolvedor da Apple estiverem instaladas. Os dois mostram exatamente o que está no arquivo, símbolos incluídos. Pressionar Espaço no Finder faz o mesmo, a não ser que algum app tenha adicionado uma pré-visualização de Markdown. O arquivo está bem; o Mac só não sabe como exibi-lo.

Como abrir do jeito certo

Uma vez, sem instalar nada: abra no Editor de Texto e leia desviando dos símbolos. Tolerável para uma nota curta, sofrido para uma tabela longa.
Na nuvem: o Documentos Google abre um arquivo .md depois que você o envia para o Google Drive. Funciona, mas significa enviar o arquivo para algum lugar, o que, para um documento particular, é uma decisão de verdade.
Em um editor de código: o VS Code mostra uma pré-visualização formatada com ⇧⌘V. Funciona, mas é ferramenta de programador e tem cara disso.
Em um app de Markdown: o Hem é um app gratuito e de código aberto para Mac feito para isso. Na primeira abertura ele se oferece para ser o app dos arquivos .md; depois, o clique duplo mostra uma página formatada, e Espaço no Finder também mostra uma pré-visualização formatada. O arquivo fica no seu Mac. O Hem só existe para Mac.

Um arquivo .md aberto no Hem: os símbolos sumiram e o relatório mostra um título, uma tabela, uma lista e passos numerados.

Se o arquivo veio de um chat de IA, continue em o ChatGPT me deu um arquivo .md.

Como editar

Qualquer editor de texto altera um arquivo .md, porque ele é só texto. O porém é que você edita os símbolos: para deixar uma palavra em negrito, digita dois asteriscos de cada lado, e precisa de uma pré-visualização para conferir o resultado.

Se preferir não aprender nada disso, use um app que esconda os símbolos enquanto você trabalha. No Hem você clica na página formatada e digita, mais ou menos como no Pages ou no Word. Selecionar texto faz aparecer uma pequena barra com negrito, itálico, títulos, listas, listas de tarefas, links e citações; ⌘B e ⌘I funcionam como esperado; Formatar › “Inserir Tabela” adiciona uma tabela; as caixas são marcadas com um clique. O Hem salva enquanto você trabalha, no mesmo arquivo .md, e reescreve só as partes alteradas. O arquivo continua sendo Markdown comum, que uma IA ou qualquer outro app consegue ler.

Como converter

Para Word: no Hem, Arquivo › “Exportar como Documento do Word…” salva um .docx. Os outros caminhos, incluindo o Documentos Google, estão em como transformar um arquivo .md em documento do Word.
Para PDF: Arquivo › “Exportar como PDF…” no Hem.
Para um e-mail ou outro documento: copie do Hem com ⌘C e cole no Mail, no Word, no Pages ou no Documentos Google. Títulos, negrito, listas e tabelas chegam como formatação, não como símbolos.
De volta para uma IA: não precisa converter. Os chats de IA leem Markdown sem dificuldade, então cole o texto ou anexe o arquivo .md como está.

Resumindo

Um arquivo .md é um documento de texto com a formatação escrita em forma de símbolos. Ele não está quebrado, não é perigoso e não é só para programadores. Só precisa de um app que leia os símbolos, e no Mac você tem que adicionar um, porque nenhum vem embutido.