Criar um arquivo Markdown é criar um arquivo de texto com a extensão .md. Você não precisa de um programa especial para começar: um editor simples já permite escrever títulos, listas e parágrafos. Um visualizador Markdown ajuda a conferir o resultado depois.
No Windows
- Abra o Bloco de Notas ou outro editor de texto.
- Escreva o conteúdo usando Markdown.
- Escolha Arquivo → Salvar como.
- Digite um nome como
anotacoes.md. - Em tipo, escolha Todos os arquivos, se essa opção aparecer.
- Se houver escolha de codificação, prefira UTF-8.
Evite o .md.txt
O Windows costuma esconder extensões conhecidas. Se você digitar anotacoes.md em um campo que salva como texto, o sistema pode criar anotacoes.md.txt.
Para conferir, abra o Explorador de Arquivos, acesse Exibir → Mostrar → Extensões de nomes de arquivo e observe o nome completo. Se terminar em .md.txt, renomeie para anotacoes.md.
No Mac
Abra o TextEdit e escolha Formatar → Converter em texto simples antes de salvar. Em seguida, use Salvar, escreva anotacoes.md e confirme que o arquivo não recebeu .txt no final.
Para escrever Markdown com preview, você também pode usar VS Code ou um editor Markdown dedicado. O arquivo continua sendo texto e pode ser aberto em qualquer outra ferramenta compatível.
No celular
No Android, use um editor de texto ou Markdown que permita escolher o nome completo do arquivo. Salve em Downloads ou em uma pasta de documentos e confirme que o nome termina em .md.
No iPhone, crie o documento em um aplicativo que salve texto simples e permita definir a extensão. Se o aplicativo não oferece esse controle, crie o arquivo no computador ou no navegador para evitar que ele seja salvo com uma extensão desconhecida.
No navegador
Um editor Markdown online é útil quando você não quer instalar nada. Abra o Sanctuary Reader, use o editor, escreva o conteúdo e confira o preview ao vivo.
O produto permite baixar o Markdown atual como .md. Ele não converte o arquivo para PDF, Word ou HTML; para isso, use uma ferramenta externa depois de salvar o conteúdo.
Estrutura mínima para começar
# Minha nota
Este é o primeiro parágrafo.
## Próximos passos
- Escrever uma seção
- Conferir o previewAbra esse exemplo no visualizador Markdown online para ver como as marcas viram estrutura. Para aprender cada elemento com exemplos lado a lado, consulte a futura referência de sintaxe Markdown.
Confira antes de compartilhar
Abra o arquivo em um visualizador e procure títulos, listas, links e blocos de código que não renderizaram como esperado. Se precisar corrigir, volte ao editor, salve novamente como .md e mantenha uma cópia da versão anterior quando o conteúdo for importante.