A resposta curta
- Markdown é um formato de escrita em texto simples que representa a estrutura de documentos com símbolos e pode ser convertido para HTML, mas não garante compatibilidade entre variantes.
- No Windows ou Mac, use a opção Abrir de um editor de texto simples para selecionar o arquivo. No celular, use um aplicativo que abra texto simples. Para visualizar com formatação no navegador, converta para HTML com uma ferramenta compatível com a variante e confira o resultado.
- A leitura como texto simples apresenta risco relativamente baixo, mas caracteres de controle Unicode maliciosos podem alterar a direção exibida do texto. A prévia em HTML pode introduzir scripts, redirecionamentos, downloads remotos e envio de informações pessoais. Verifique e filtre ou bloqueie o conteúdo de risco, conforme a [seção 2 da RFC 7763](https://www.rfc-editor.org/rfc/rfc7763.html#section-2).
Arquivos Markdown (.md, .markdown): abrir e converter
Arquivos .md e .markdown contêm texto legível. A sintaxe original oferece títulos, listas, citações, código, ênfase, links e imagens. Consulte a [descrição original do Markdown](https://daringfireball.net/projects/markdown/).
Use um conversor de Markdown para HTML que aceite a variante do documento. Confira a saída: a sintaxe original permite HTML incorporado, mas não interpreta Markdown dentro de blocos HTML. Consulte a [documentação da sintaxe](https://daringfireball.net/projects/markdown/syntax).
Como abrir
No Windows ou Mac, use a opção Abrir de um editor de texto simples para selecionar o arquivo. No celular, use um aplicativo que abra texto simples. Para visualizar com formatação no navegador, converta para HTML com uma ferramenta compatível com a variante e confira o resultado.
No Windows ou Mac, use a opção Abrir de um editor de texto simples para selecionar o arquivo. No celular, use um aplicativo que abra texto simples. Para visualizar com formatação no navegador, converta para HTML com uma ferramenta compatível com a variante e confira o resultado.
Use um conversor de Markdown para HTML que aceite a variante do documento. Confira a saída: a sintaxe original permite HTML incorporado, mas não interpreta Markdown dentro de blocos HTML. Consulte a [documentação da sintaxe](https://daringfireball.net/projects/markdown/syntax).
Segurança
A leitura como texto simples apresenta risco relativamente baixo, mas caracteres de controle Unicode maliciosos podem alterar a direção exibida do texto. A prévia em HTML pode introduzir scripts, redirecionamentos, downloads remotos e envio de informações pessoais. Verifique e filtre ou bloqueie o conteúdo de risco, conforme a [seção 2 da RFC 7763](https://www.rfc-editor.org/rfc/rfc7763.html#section-2).
Remetente desconhecido, nome terminando em duas extensões ou conteúdo que não bate com a extensão: confira antes de abrir.
Como converter
Use um conversor de Markdown para HTML que aceite a variante do documento. Confira a saída: a sintaxe original permite HTML incorporado, mas não interpreta Markdown dentro de blocos HTML. Consulte a [documentação da sintaxe](https://daringfireball.net/projects/markdown/syntax).
Converta uma cópia, nunca o original, e depois compare qualidade, metadados e diagramação com o arquivo de partida.
Perguntas frequentes
O que é e para que serve um arquivo Markdown?
É um documento de texto simples com símbolos para títulos, listas, links e outras estruturas. As extensões comuns são .md e .markdown, e o documento pode ser convertido para HTML.
Como abrir um arquivo MD no Windows?
Em um editor de texto simples, escolha Abrir e selecione o arquivo .md. Isso permite ler e editar o texto de origem; a visualização formatada exige um renderizador Markdown.
Como abrir um arquivo Markdown no Mac?
Use a opção Abrir de um editor de texto simples. Para ver o documento formatado, escolha um visualizador compatível com a variante Markdown usada no arquivo.
Como abrir um arquivo Markdown no celular?
Abra o arquivo em um aplicativo que aceite texto simples. Para visualizar a formatação, use um aplicativo com suporte à variante Markdown do documento.
Como visualizar Markdown no navegador?
Use um visualizador compatível com a variante do arquivo ou converta o documento para HTML e abra o resultado no navegador. O envio do arquivo e a filtragem de HTML dependem do serviço escolhido.
Por que Markdown muda de formatação entre editores?
Os editores podem usar variantes diferentes e interpretar ou ignorar determinadas marcas. Confira a compatibilidade da variante e a presença de blocos HTML, nos quais o Markdown original não processa marcas Markdown.
Devo escolher Markdown ou HTML para um documento?
Escolha Markdown para escrever texto simples legível com marcas estruturais curtas. Escolha HTML quando precisar expressar diretamente a marcação da página. Markdown pode ser convertido para HTML.
Como converter Markdown para HTML sem perder a formatação?
Use um conversor compatível com a variante de origem e compare a saída com o arquivo. A preservação entre variantes não é garantida; o Markdown original não interpreta suas marcas dentro de blocos HTML.
Scripts podem ser executados na prévia de Markdown?
Sim, se o visualizador permitir HTML incorporado com conteúdo ativo. Também podem ocorrer redirecionamentos e acessos remotos. Use filtragem ou bloqueio da marcação e leia arquivos desconhecidos primeiro como texto simples.
Qual é o tipo MIME de um arquivo Markdown e existe um número mágico?
A RFC 7763 registra text/markdown e as extensões .md e .markdown. Não define um número mágico nem uma assinatura fixa de bytes.
Formatos relacionados
Fontes
Daring Fireball: Markdown · 格式原作者 John Gruber 的官方网站
Markdown Syntax Documentation · 格式原作者发布的语法说明
RFC 7763: The text/markdown Media Type · IETF 发布的 Markdown 媒体类型注册文档