O que é Markdown?

Markdown é uma linguagem de marcação leve criada por John Gruber em 2004. Ela permite escrever documentos formatados usando sintaxe de texto simples que é fácil de ler e escrever. Markdown é amplamente usado em README files, documentação, blogs, fóruns e sistemas de gerenciamento de conteúdo.

Sintaxe Markdown Básica

Cabeçalhos

# H1
## H2
### H3

Ênfase

**negrito**
*itálico*
~~tachado~~

Listas

- Item 1
- Item 2

1. Primeiro
2. Segundo

Links e Imagens

[texto](url)
![alt](imagem.jpg)

Código

`código inline`

```
bloco de código
```

Citações

> Citação
> multilinha

---

Casos de Uso Comuns

README.md: Documentação de projetos no GitHub, GitLab, etc.
Blogs: Muitos sistemas (Jekyll, Hugo, Gatsby) usam Markdown
Documentação: MkDocs, Docusaurus, GitBook
Notas: Obsidian, Notion, Bear, Joplin
Fóruns: Stack Overflow, Reddit, Discord
Emails: Alguns clientes suportam Markdown
Comentários: Muitos sistemas de comentários (Discourse, etc.)

Vantagens do Markdown

✅ Benefícios

• Simples e fácil de aprender
• Legível em formato texto puro
• Amplamente suportado
• Independente de plataforma
• Fácil controle de versão (Git)
• Foco no conteúdo, não na formatação

⚠️ Limitações

• Formatação limitada comparada a HTML
• Variações entre implementações
• Sem suporte nativo a tabelas complexas
• Estilos customizados requerem HTML/CSS
• Não ideal para layouts complexos

Sabores de Markdown

Existem várias "versões" de Markdown com extensões adicionais:

CommonMark: Especificação padronizada de Markdown
GitHub Flavored Markdown (GFM): Adiciona tabelas, listas de tarefas, menções
Markdown Extra: Tabelas, notas de rodapé, definições
MultiMarkdown: Metadados, referências cruzadas, matemática
Pandoc Markdown: Extensões acadêmicas e científicas

Limitações desta Ferramenta

⚠️ Nota: Esta é uma ferramenta básica que suporta sintaxe Markdown comum. Para conversão avançada, use:

marked.js: Biblioteca JavaScript popular
markdown-it: Parser extensível com plugins
Pandoc: Conversor universal de documentos
remark: Processador Markdown com ecosistema de plugins

Exemplo Completo

Markdown:

# Meu Projeto

## Instalação

```bash
npm install meu-pacote
```

## Uso

Use assim:

- Importe o módulo
- Configure as opções
- Execute!

**Importante:** Leia a documentação.

[Docs](https://exemplo.com)

HTML Gerado:

<h1>Meu Projeto</h1>

<h2>Instalação</h2>

<pre><code>npm install...</code></pre>

<h2>Uso</h2>

<p>Use assim:</p>

<ul>
  <li>Importe o módulo</li>
  <li>Configure...</li>
</ul>

<p><strong>Importante:</strong>...</p>

Melhores Práticas

Consistência: Escolha um estilo (-, *, __, etc.) e mantenha-o
Quebras de linha: Use linha em branco para separar parágrafos
Links: Use URLs completas, não relativas quando possível
Acessibilidade: Sempre adicione texto alt em imagens
Heading hierarchy: Use níveis de cabeçalho sequenciais (H1 → H2 → H3)
Code blocks: Especifique a linguagem para syntax highlighting

Editores Markdown Recomendados

Desktop

• Typora
• Obsidian
• VS Code
• MarkText

Online

• Dillinger
• StackEdit
• HackMD
• Notion

Mobile

• iA Writer
• Bear
• Joplin
• Drafts

Perguntas Frequentes

Markdown vs HTML: Qual usar?

Use Markdown para conteúdo simples e legível. Use HTML quando precisar de controle total sobre layout e estilo. Muitos sistemas permitem misturar ambos quando necessário.

Como adicionar tabelas em Markdown?

Tabelas não fazem parte do Markdown original, mas são suportadas em GFM (GitHub Flavored Markdown) e outros sabores. Esta ferramenta básica não suporta tabelas, mas bibliotecas como markdown-it suportam.

Posso usar HTML dentro de Markdown?

Sim! A maioria dos parsers Markdown permite HTML inline para casos que Markdown não cobre. É especialmente útil para elementos complexos ou estilização customizada.

Conversor Markdown para HTML Online

Markdown para HTML

📝 Sintaxe Markdown Suportada