Como usar a ferramenta Editor de Markdown
- EscrevaDigite Markdown no painel esquerdo ou abra um arquivo .md. A pré-visualização à direita se atualiza enquanto você digita.
- FormateUse a barra para títulos, negrito, links, listas, tabelas e código, ou os atalhos Ctrl+B, Ctrl+I e Ctrl+K.
- Escolha uma visualizaçãoTrabalhe lado a lado ou mude para Escrever ou Pré-visualizar para usar toda a largura.
- ExporteBaixe o arquivo Markdown, uma página HTML pronta para publicar ou um PDF, ou copie o código HTML.
Recursos
- Pré-visualização ao vivoVeja títulos, listas, tabelas, citações e blocos de código formatados enquanto digita.
- GitHub Flavored MarkdownTabelas, listas de tarefas, tachado e blocos de código funcionam como no GitHub.
- Edição inteligenteListas e citações continuam ao pressionar Enter, e Tab recua as linhas selecionadas.
- Salvamento automáticoSeu rascunho fica neste navegador, então recarregar ou fechar a aba não faz você perder o trabalho.
O que é Markdown?
Markdown é um jeito simples de formatar texto usando caracteres comuns: uma linha que começa com # vira título, **texto** fica em negrito e uma linha que começa com - vira item de lista. Ele é usado em arquivos README, documentação, apps de notas, fóruns e sites estáticos porque se escreve rápido e se lê bem mesmo antes de ser formatado.
Guia rápido de Markdown
| Você digita | Você obtém |
|---|---|
| # Título, ## Título | Título de nível 1 e nível 2 |
| **negrito**, *itálico*, ~~tachado~~ | negrito, itálico, tachado |
| [texto](https://example.com) | Um link |
| - item ou 1. item | Lista com marcadores ou numerada |
| - [ ] tarefa | Caixa de seleção |
| > citação | Bloco de citação |
| `código` e ``` cercas | Código em linha e blocos de código |
| --- | Linha horizontal |
O GitHub Flavored Markdown funciona: tabelas, listas de tarefas, tachado e blocos de código, igual ao GitHub. A prévia ao vivo mostra títulos, listas, tabelas, citações e código enquanto você digita. Ao apertar Enter, listas e citações continuam sozinhas, e Tab recua as linhas selecionadas.
Onde seu trabalho fica salvo
O editor funciona no seu navegador. O rascunho é salvo sozinho no armazenamento local deste navegador, então recarregar ou fechar a aba não faz você perder nada. Nada é enviado, a não ser que você escolha «Baixar PDF»: aí a página formatada vai para o nosso mecanismo de PDF e é apagada logo em seguida. Se você usar «Imprimir» e escolher «Salvar como PDF», o PDF é criado inteiramente no seu dispositivo. A exportação HTML é uma página completa com estilos legíveis, e o PDF vem com números de página. O HTML dentro do seu Markdown é higienizado na prévia, então conteúdo colado não consegue executar scripts.
Para converter arquivos que você já tem, use Markdown para HTML, ou no sentido contrário HTML para Markdown.
Quem usa Markdown?
- Desenvolvedores: escrevem README, documentação e descrições de pull requests. GitHub, GitLab e Bitbucket exibem Markdown.
- Blogueiros e redatores: escrevem sem brigar com um editor visual. Jekyll, Hugo, Ghost e muitas outras plataformas publicam Markdown direto.
- Estudantes: fazem anotações em apps como Obsidian, Notion e Joplin, que usam Markdown.
- Equipes: formatam mensagens no Slack, Discord e Reddit com os mesmos símbolos.
Dicas de escrita
- Deixe uma linha em branco entre parágrafos, e antes e depois de listas, títulos e blocos de código. A maioria dos problemas de formatação vem de uma linha em branco que faltou.
- Use um único título # para o nome do documento e ## para as seções. Uma hierarquia de títulos clara também dá resultado melhor quando o texto vira página web.
- Indique a linguagem depois das três crases de um bloco, por exemplo ```python, para que sites com realce de sintaxe colorem o código corretamente.
- Um arquivo .md é texto puro: abre em qualquer editor e dispositivo, e vai continuar legível daqui a décadas.