O que MarkCraft faz?
MarkCraft: Transforme documentos Markdown, READMEs e anotações técnicas em relatórios PDF de alta legibilidade com visual tecnológico, com opção de personalização de marca (nome da equipe e slogan). Agent Skill + CLI para relatórios Markdown-para-PDF polidos e legíveis com suporte CJK, tabelas limpas, blocos de código, citações, ícones e exemplos reais.
Visão Geral
MarkCraft converte seu Markdown em PDFs visualmente impressionantes, prontos para uso em documentação técnica, relatórios de projetos ou comunicação com clientes.
Funcionalidades
- Suporte CJK: Renderização correta de caracteres chineses, japoneses e coreanos.
- Tabelas Limpas: Tabelas formatadas com estilo profissional, com cabeçalhos destacados e linhas alternadas.
- Blocos de Código: Destaque de sintaxe com fundo escuro ou claro, conforme preferência.
- Citações: Blocos de citação estilizados com ícone e fundo suave.
- Ícones: Suporte a ícones inline (como
:warning:,:info:,:tip:) para destacar avisos, dicas e informações. - Exemplos Reais: Inclusão de exemplos de código e saída diretamente no Markdown.
- Marca Personalizada: Adicione o nome da sua equipe e slogan no cabeçalho ou rodapé.
Como Usar
Como Agente de IA
Simplesmente descreva o que deseja em linguagem natural. Por exemplo:
"Converta este README em um PDF com visual tecnológico, adicione o nome da equipe 'Acme Corp' e o slogan 'Inovação Acelerada'."
O agente interpretará seu comando e gerará o PDF usando MarkCraft.
Como CLI
# Instalação via npm (exemplo)
npm install -g @ficere/markcraft
# Uso básico
markcraft input.md -o output.pdf
# Opções avançadas
markcraft input.md -o output.pdf --team "Acme Corp" --slogan "Inovação Acelerada" --theme dark
Opções da CLI
| Opção | Descrição | Padrão |
|---|---|---|
-o, --output | Caminho do arquivo PDF de saída | output.pdf |
--team | Nome da equipe para o cabeçalho | vazio |
--slogan | Slogan para o cabeçalho | vazio |
--theme | Tema: light ou dark | light |
--font-size | Tamanho da fonte base (em pt) | 11 |
--page-size | Tamanho da página: A4, Letter, etc. | A4 |
Exemplo de Uso
Entrada (Markdown)
# Relatório Técnico
> :info: Este relatório descreve as métricas de desempenho.
## Tabela de Métricas
| Métrica | Valor | Status |
|---------|-------|--------|
| Latência | 12ms | ✅ |
| Throughput | 1500 req/s | ✅ |
| Erro | 0.5% | ⚠️ |
## Código de Exemplo
```python
def calcular_media(valores):
return sum(valores) / len(valores)
### Saída (PDF)
O PDF resultante terá:
- Cabeçalho com nome da equipe e slogan (se configurado)
- Tabela formatada com linhas alternadas
- Bloco de citação com ícone e destaque
- Bloco de código com destaque de sintaxe
- Rodapé com número de página
## Requisitos
- Node.js 16+ (para uso CLI)
- Fonte CJK instalada no sistema (para suporte a chinês, japonês e coreano)
## Licença
MIT