Português ▾
Free, Fast & Secure Online Tools
Markdown é um jeito de escrever texto formatado dentro de um arquivo de texto puro. Nenhum aplicativo é dono dele, não há formato binário, não há compatibilidade de versão para vigiar. Você escreve símbolos que já se parecem com a formatação que produzem, e depois outra coisa os transforma em títulos e negrito.
Foi inventado em 2004 para escrever posts sem digitar HTML. Duas décadas depois é o formato de entrada da maioria dos apps de notas, de quase toda documentação técnica, de ferramentas de chat, de geradores de sites estáticos, e o jeito como as pessoas escrevem instruções e documentos para ferramentas de IA. Ninguém o padronizou nessa posição; ele se espalhou porque é legível antes de ser renderizado.
# Título — uma cerquilha para o maior, mais cerquilhas para os menores.**negrito** e *itálico*.- item no início da linha para marcador; 1. item para lista numerada.[texto](https://example.com) para um link. para imagem — o mesmo com exclamação na frente.> texto citado para uma citação.código.É quase tudo. Dá para aprender inteiro no tempo de ler esta seção, que é a segunda razão da sua difusão.
Os dois descrevem texto estruturado e os dois são arquivos de texto puro. A diferença é o que acontece quando uma pessoa olha o código-fonte.
HTML embrulha tudo em tags. Um parágrafo com uma palavra em negrito carrega mais pontuação que linguagem. É inequívoco e as máquinas adoram, mas lê-lo dá trabalho e escrevê-lo à mão é lento.
Os símbolos do Markdown foram escolhidos para parecer o que significam. Uma lista parece uma lista antes de qualquer coisa renderizá-la. Um título salta. Ênfase marcada com asteriscos se lê como ênfase. O fonte não renderizado já é legível, o que significa que um arquivo Markdown serve mesmo aberto no editor mais básico de uma máquina sem nada instalado.
O custo de uma nota feita num app proprietário é invisível até o dia em que você quer tirar tudo de lá. O Markdown não tem esse dia.
O básico é idêntico em todo lugar. A divergência começa nas tabelas e no que vem depois, por isso um documento pode ficar certo num app e sutilmente errado em outro. Fique na sintaxe central se o arquivo for viajar.
Markdown não controla tamanho de página, margens, fontes, colunas, espaçamento exato nem onde a página quebra. Não é descuido — é o projeto. Markdown descreve o que uma coisa é (um título, uma citação, uma lista), não como ela parece. A aparência é decidida depois por quem renderiza.
Então Markdown é errado para um documento desenhado: um folheto, um cartaz, um formulário, um contrato cujo layout faz parte do sentido. É certo para texto cuja estrutura importa e cuja aparência pode ser decidida rio abaixo.
Como Markdown é um formato de origem, entregar geralmente significa converter. Para HTML na web, para PDF quando alguém precisa de uma página fixa para imprimir ou assinar, para Word quando um revisor vai marcar alterações, para slides em ferramentas de apresentação.
A disciplina que vale manter: converta para fora, nunca edite a saída e a chame de original. No momento em que as correções passam a morar no PDF exportado, o arquivo Markdown vira uma cópia vencida e a vantagem some.
Quem mantém notas que espera ter daqui a dez anos, quem escreve documentação, quem redige texto que vai parar em vários lugares. Custa uma tarde para aprender e elimina uma categoria inteira de problema futuro.
É a ferramenta errada para um documento que precisa parecer exatamente com algo, e para colaboradores que precisam de um processador de texto familiar. São limitações reais, não razões para descartá-lo.
# título, **negrito**, *itálico*, - lista, [texto](url)