Como abrir um arquivo .md no Windows, Mac e iPhone

O que é um arquivo .md?

Markdown é o formato de texto puro usado por READMEs do GitHub, sites de documentação e aplicativos de notas. A extensão .md significa que o arquivo contém o código Markdown, não um documento pronto: um editor de texto mostra a sintaxe e um visualizador de Markdown mostra o resultado. Não conhece a sintaxe? O guia de Markdown cobre todos os elementos com exemplos ao vivo.

Como abrir um arquivo .md no Windows

1. Clique duas vezes no arquivo. O Windows costuma abrir arquivos .md no Notepad, que mostra o texto Markdown sem formatação.
2. Clique com o botão direito e escolha Abrir com para selecionar outro aplicativo: Notepad, Visual Studio Code ou um navegador.
3. Para ver renderizado, abra esta página no Edge, Chrome ou Firefox e arraste o arquivo para a janela.
4. Ou use um aplicativo com pré-visualização: pressione Ctrl + Shift + V no Visual Studio Code, ou abra o arquivo no Obsidian ou Typora.
5. Se o arquivo veio de e-mail ou download, o Windows pode bloqueá-lo: clique com o botão direito, abra Propriedades, marque Desbloquear e abra de novo.

O Windows não tem visualizador de Markdown embutido, então o clique duplo sempre mostra o texto original, a menos que você instale um aplicativo ou use o navegador.

Como abrir um arquivo .md no Mac

1. Selecione o arquivo no Finder e pressione Espaço. O Quick Look mostra uma pré-visualização, geralmente como texto puro.
2. Clique duas vezes para abrir no aplicativo padrão. Se for o TextEdit, ele abre como texto puro e não renderiza o Markdown.
3. Para ver renderizado, abra esta página no Safari ou Chrome e arraste o arquivo para a janela.
4. Ou pressione Cmd + Shift + V no Visual Studio Code, ou abra o arquivo no MacDown ou Obsidian.

O Quick Look não renderiza Markdown sozinho: a pré-visualização com a barra de espaço mostra os símbolos, não títulos e tabelas.

Como abrir um arquivo .md no iPhone e iPad

1. Salve o arquivo primeiro se ele chegou por e-mail ou Mensagens: toque no anexo e depois em Compartilhar → Salvar em Arquivos.
2. Abra o aplicativo Arquivos, encontre o arquivo (geralmente em Downloads ou No meu iPhone) e toque nele. O iOS mostra o texto bruto.
3. Para ver renderizado, abra o Safari, acesse esta página, toque em Abrir, depois em Abrir arquivo… e escolha o arquivo em Arquivos ou iCloud Drive.
4. Para editar Markdown no iOS use um aplicativo como Textastic, Obsidian ou Working Copy. Notas e Pages da Apple não leem arquivos .md como Markdown.

No iPhone e iPad o arquivo fica no seu dispositivo: o navegador o lê localmente e nada é enviado.

Ler ou editar um arquivo .md

Um visualizador apenas exibe o documento. Se precisar alterá-lo, esta ferramenta também é um editor de Markdown: mude para Dividido ou Editar, escreva seu conteúdo e exporte para PDF, Word, HTML ou PNG. As alterações são salvas no seu navegador, não em um servidor.

Problemas comuns

Por que o arquivo abre como texto com # e *?

Isso é o código Markdown, não um erro de renderização. Um arquivo .md é texto puro e os símbolos são as instruções de formatação. Abra-o em um visualizador de Markdown para ver títulos, listas e tabelas formatados.

O Windows não abre o arquivo ou pergunta com qual aplicativo

O Windows não tem aplicativo padrão para .md, então a caixa "Como você quer abrir este arquivo?" é normal. Escolha Notepad para ler o código ou um navegador para ver renderizado.

O navegador baixa o arquivo em vez de exibi-lo

Alguns servidores enviam arquivos .md com um tipo de conteúdo que o navegador não exibe e fazem o download. Abra esta página primeiro e use Abrir arquivo… para carregar o documento do seu dispositivo.

O arquivo está dentro de um ZIP

Extraia o arquivo primeiro (clique com o botão direito → Extrair tudo no Windows, clique duplo no Mac ou o app Arquivos no iOS) e depois abra o .md.

Onde foi parar meu download no iPhone?

Abra o aplicativo Arquivos e veja em Downloads no iCloud Drive ou em No meu iPhone. Se abriu pelo Mail, salve antes em Arquivos pelo menu de compartilhamento.

É seguro abrir um arquivo .md?

Um arquivo .md é texto, então não se executa sozinho. Ele pode conter links para imagens e outros sites, então trate links inesperados como faria em um e-mail. Com esta ferramenta o arquivo é processado localmente no navegador e nunca é enviado: veja a política de privacidade.

Posso abrir um arquivo .md sem instalar nada?

Sim. Um navegador basta: arraste o arquivo para o editor desta página ou use Abrir arquivo… e ele é renderizado na hora no Windows, Mac, Linux, ChromeOS, Android, iPhone e iPad.