Kit de Publicação de Documentos

## Visão Geral
O Kit de Publicação de Documentos oferece um fluxo para transformar anotações técnicas brutas em documentação pronta para publicação: redija o conteúdo, limpe a estrutura markdown e depois exporte HTML polido para compartilhar.

## Início Rápido
1. Comece com `documentation` quando precisar escrever ou reformular planos, propostas, especificações, READMEs, notas, guias ou outros documentos em markdown.
2. Execute `baoyu-format-markdown` no rascunho para limpar frontmatter, títulos, resumos, cabeçalhos, texto em negrito, listas e blocos de código. Ele gera um arquivo `{filename}-formatted.md` formatado.
3. Use `baoyu-markdown-to-html` quando o markdown finalizado precisar de saída HTML estilizada, incluindo suporte para highlighting de código, matemática, PlantUML, notas de rodapé, alertas e conteúdo amigável para infográficos.

## Comandos Principais
- `documentation` — Redija documentos estruturados como especificações, READMEs, propostas, planos, notas, guias e arquivos markdown.
- `jimliu-baoyu-format-markdown` / `baoyu-format-markdown` — Formate texto simples ou markdown em um layout de documento mais limpo com cabeçalhos, listas, frontmatter e tipografia.
- `jimliu-baoyu-markdown-to-html` / `baoyu-markdown-to-html` — Converta markdown concluído em HTML estilizado para web ou publicação de conteúdo rico.

## Dicas
- Mantenha o fluxo sequencial: escreva com `documentation`, refine com `baoyu-format-markdown` e depois publique com `baoyu-markdown-to-html`.
- Use a saída markdown formatada como única fonte antes da conversão HTML para que README, especificação e página publicada permaneçam alinhados.
- Para documentos técnicos com diagramas ou matemática, termine o markdown primeiro e deixe `baoyu-markdown-to-html` cuidar de PlantUML, matemática, notas de rodapé, alertas e highlighting de código na exportação HTML.