Se você baixou um projeto do GitHub, instalou software via npm ou trabalhou com qualquer ferramenta de desenvolvimento, certamente encontrou um arquivo chamado README.md. Mas o que exatamente é um arquivo .md — e por que você não pode simplesmente clicar duas vezes nele para ler?

O que É um Arquivo .md?

Um arquivo .md (abreviação de Markdown) é um arquivo de texto simples que usa uma sintaxe simples para definir formatação. A extensão .md indica que o texto dentro segue as convenções Markdown.

Quando um arquivo Markdown é renderizado, essas convenções produzem formatação visual:

Quem Criou o Markdown?

John Gruber criou o Markdown em 2004, com contribuições significativas de Aaron Swartz. O objetivo era um formato legível como texto simples, mas que também pudesse ser convertido em HTML limpo.

Onde os Arquivos MD São Usados?

O Markdown tornou-se o formato padrão de texto em muitos contextos:

• GitHub — README.md, CONTRIBUTING.md, modelos de issues, wikis
• Documentação — Docusaurus, MkDocs, GitBook, exportações do Notion
• Geradores de sites estáticos — Jekyll, Hugo, Gatsby, Nuxt Content
• Anotações — Obsidian, Notion, Bear, Typora
• Plataformas de chat — Slack e Discord suportam formatação Markdown
• Escrita acadêmica — R Markdown, Pandoc, Jupyter Notebooks

Como Abrir um Arquivo .md?

Seu sistema operacional não sabe como renderizar Markdown por padrão:

• Windows abre arquivos .md no Bloco de Notas — você verá texto bruto
• Mac abre no TextEdit — também texto bruto

Para ler um arquivo Markdown como pretendido, você precisa de uma ferramenta que o renderize:

1. Online — MDViewer.org: arraste seu arquivo, leia instantaneamente
2. VS Code — abra o arquivo, pressione Ctrl+Shift+V (Windows) ou Cmd+Shift+V (Mac)
3. GitHub — faça upload do arquivo; o GitHub o renderiza automaticamente
4. Aplicativos dedicados — Typora, Obsidian, Zettlr

Por que os Desenvolvedores Usam Markdown?

O Markdown conquistou as ferramentas de desenvolvimento por vários motivos:

1. Portátil — Texto simples funciona em qualquer lugar. Git pode fazer diff. Email pode enviar. Todo editor pode abrir.

2. Legível bruto — Mesmo sem renderização, ## Introdução é claramente um título. Isso não é verdade para HTML ou documentos Word.

3. Rápido de escrever — Sem cliques em menus para formatação. Digite **palavra** e continue.

4. Controlável por versão — Por ser texto, os arquivos Markdown funcionam perfeitamente com Git.

5. Converte para qualquer coisa — Com ferramentas como Pandoc, Markdown converte para PDF, Word, LaTeX, HTML e muito mais.

Referência de Sintaxe Markdown

# Título 1
## Título 2
### Título 3

**texto em negrito**
*texto em itálico*
~~tachado~~

- Item de lista não ordenada
1. Item de lista ordenada

[Texto do link](https://example.com)
![Alt da imagem](imagem.png)

`código inline`

```python
print("Olá, mundo!")

Citação em bloco

## Qual é a Diferença Entre .md e .mdx?

**MDX** (`.mdx`) é uma extensão do Markdown que permite incorporar componentes JSX dentro de arquivos Markdown. É usado em frameworks de documentação baseados em React como Nextra e Docusaurus v3. Para escrita e documentação padrão, arquivos `.md` regulares são quase sempre suficientes.

## Perguntas Frequentes

### Posso criar um arquivo .md eu mesmo?

Sim — abra qualquer editor de texto, escreva conteúdo Markdown e salve com a extensão `.md`.

### O Markdown é o mesmo em todas as plataformas?

A sintaxe Markdown principal é padrão, mas muitas plataformas adicionam extensões — o GitHub Flavored Markdown (GFM) adiciona tabelas, listas de tarefas e tachado.

### Qual é o tamanho máximo de um arquivo .md?

Não há limite prático de tamanho. Arquivos grandes funcionam bem. O desempenho depende da ferramenta de visualização, não do formato.

---

Arquivos Markdown são um dos formatos de texto simples mais práticos já criados. Se você encontra arquivos `.md` regularmente, um **visualizador MD online** como [MDViewer.org](https://mdviewer.org) é a maneira mais rápida de lê-los sem instalar nada.