Markdown é uma sintaxe de formatação de texto leve que transforma texto simples em documentos estruturados. Criado em 2004 por John Gruber, é agora o formato padrão para documentação, arquivos README, postagens de blog e comunicação com desenvolvedores. Este guia explica o que é Markdown, por que as pessoas o usam e como começar.
O que é o Markdown?
Markdown é uma maneira de adicionar formatação ao texto simples usando caracteres de pontuação simples. Você escreve em um editor de texto, e o Markdown é renderizado em saída formatada (HTML, PDF, etc.) por um processador.
Por exemplo:
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item twoDescrição:
Esta é uma rubrica
Isto é um em negrito E isto é italic.
- Número 1 da lista
- Ponto 2 da lista
A formatação vive no próprio texto sem XML oculto, sem formato binário, sem codificação proprietária.
Por que foi criado o Markdown?
Antes do Markdown, os escritores da web enfrentavam uma escolha: escrever em HTML bruto (tedioso e propenso a erros) ou usar um editor WYSIWYG que produzia código desordenado. John Gruber projetou Markdown para ser:
- Legível tal como está Mesmo sem renderização,
**bold**lê-se claramente como ênfase - Pode ser escrito por qualquer um. Sem software especial, apenas um editor de texto
- Convertível para HTML O formato de saída primário
A especificação original focou na produção de HTML limpo. Mas Markdown desde então se espalhou para dezenas de plataformas e formatos de saída.
Onde é usado o Markdown?
Markdown está em toda a tecnologia:
| Plataforma | O que Markdown faz |
|---|---|
| GitHub | README, problemas, solicitações de extração, wikis |
| Notion | Conteúdo da página e documentos |
| Obsidian | Todas as notas no cofre . |
| WordPress (em inglês) | Publicações através do plugin Markdown |
| GitBook | Páginas de documentação |
| Slack / Discórdia | Formatação de mensagens |
| Superfluxo de pilhas | Perguntas e respostas |
| Jekyll / Hugo / Astro | Publicações em blogs e páginas estáticas |
| Cadernos de Júpiter | Células de documentação |
Se você escrever qualquer conteúdo técnico, você quase certamente encontrou Markdown.
Markdown vs. Word: Principais diferenças
| Aspectos | Word | Markdown |
|---|---|---|
| Formatos | Binário (.docx) | Texto simples (.md) |
| Portabilidade | Requer Word ou aplicativo compatível | Abre em qualquer editor de texto |
| Controle de versões | Difícil (diferências binárias) | Fácil (linha-por-linha Diferenças Git) |
| Reprodução | Integrado no aplicativo | Requer um renderizador Markdown |
| Curva de aprendizagem | WYSIWYG (sem aprendizagem) | Requer aprendizagem de sintaxe |
| Apoio à plataforma | Ecossistema da Microsoft | Ferramentas universais para desenvolvedores |
Se você tem Word documentos que você deseja converter para Markdown, WordToMD Não há inscrição, não há upload.
Sintase básica Markdown
Eis os elementos mais comuns:
Lista de rubricas
# Heading 1
## Heading 2
### Heading 3A seguir: Markdown Guia de cabeçalhos para a referência completa.
Enfatização
**Bold text**
*Italic text*
~~Strikethrough~~Listas
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. ThirdLigações
[Link text](https://example.com)Imagens
Código
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |A seguir: Markdown Tabelas: um guia completo.
Quotas de bloco
> This is a blockquote.
> It can span multiple lines.Markdown Sabores
Markdown não é um único padrão existem várias variantes:
- CommonMark Uma especificação rigorosa e inequívoca
- GitHub Aromatizado Markdown (GFM) CommonMark + tabelas, listas de tarefas, passagens, ligações automáticas
- MultiMarcação Adiciona notas de rodapé, citações, metadados
- Pandoc Markdown Mais rico em recursos, usado pelo conversor Pandoc
A maioria das plataformas suporta pelo menos CommonMark. GitHub, Obsidian, e GitBook usam GFM. Para uma referência completa, ver Markdown Síntase guia rápido.
Como escrever Markdown
Não precisas de software especial. As opções incluem:
- Código VS Editor gratuito e poderoso com pré-visualização em Markdown
- Obsidian Markdown aplicativo de anotações com visualização gráfica
- Typora Editor WYSIWYG Markdown
- iA Escritor Ambiente de escrita focado
- Qualquer editor de texto simples Bloco de notas, TextEdit, vim, emacs
Converter entre Markdown e outros formatos
Se você tem Word documentos para converter para Markdown, WordToMD faz isso em segundos, completamente grátis, sem carregamento de arquivos.
Para o reverso (Markdown para Word ou PDF), ferramentas como Pandoc lidam com essa conversão. A seguir: Pandoc Word para Markdown para instruções de instalação.
FAQ
É Markdown uma linguagem de programação? - Não, não. Markdown é uma linguagem de marcação descreve formatação, não lógica ou computação.
Posso usar Markdown em Microsoft Word? Word não renderiza nativamente Markdown, mas existem Word add-ins que adicionam suporte Markdown. Alternativamente, converter Word para Markdown com WordToMD e usar um editor Markdown.
O Markdown é bom para documentos longos? Sim, com boa estrutura de direcção. Documentos muito longos se beneficiam de se dividir em vários arquivos (como nos cofres GitBook ou Obsidian).
Que extensão de arquivo Markdown usa?
.md É o padrão. .markdown também é válido. Algumas plataformas utilizam .mdx para Markdown com componentes JSX (React).
Conclusão
Markdown é um formato simples e poderoso que tornou-se a lingua franca da escrita técnica. É legível como texto simples, renderiza lindamente e funciona com todas as principais ferramentas de desenvolvedor. Se é novo, comece com o Markdown Síntase guia rápido e tentar converter o seu primeiro documento Word em WordToMD.