O que claude-skill-pdf faz?
Skill do Claude Code: Converta Markdown em PDFs com estilo profissional usando pandoc + weasyprint. Múltiplos templates, modo lote, suporte a CJK.
Visão Geral
Esta skill permite que você converta arquivos Markdown em PDFs visualmente atraentes usando pandoc para a transformação inicial e weasyprint para a renderização final do PDF. Você pode escolher entre vários templates pré-definidos, processar vários arquivos de uma só vez e garantir a renderização correta de caracteres CJK (Chinês, Japonês, Coreano).
Pré-requisitos
Certifique-se de que as seguintes ferramentas estão instaladas em seu sistema:
- pandoc:
sudo apt install pandoc(ou equivalente no seu sistema) - weasyprint:
pip install weasyprint - Fonte CJK (opcional, para suporte a CJK):
sudo apt install fonts-noto-cjk
Instalação
- Copie a pasta da skill para o diretório de skills do Claude Code:
cp -r wangmhao/claude-skill-pdf ~/.claude/skills/ - Ative a skill no arquivo de configuração do Claude Code (ex.:
~/.claude/config.yaml).
Uso
Comando Básico
claude-skill-pdf convert input.md -o output.pdf
Selecionar um Template
claude-skill-pdf convert input.md -o output.pdf --template modern
Templates disponíveis: default, modern, academic, report, letter.
Modo Lote
claude-skill-pdf batch *.md -o output_dir/
Isso converterá todos os arquivos .md no diretório atual para PDFs dentro de output_dir/.
Suporte a CJK
claude-skill-pdf convert input.md -o output.pdf --cjk
Esta flag habilita a renderização correta de caracteres CJK usando a fonte especificada.
Templates
A skill inclui os seguintes templates:
| Template | Descrição |
|---|---|
default | Estilo limpo e minimalista. |
modern | Design moderno com cores destacadas. |
academic | Estilo acadêmico formal (citações, etc.). |
report | Layout de relatório empresarial. |
letter | Formato de carta. |
Você pode usar templates personalizados fornecendo o caminho para um arquivo .html via opção --template-path.
Sintaxe Markdown Suportada
Quase toda a sintaxe Markdown padrão é suportada, incluindo:
- Cabeçalhos (
#,##, etc.) - Listas ordenadas e não ordenadas
- Tabelas
- Blocos de código (com destaque de sintaxe)
- Ênfase (negrito, itálico)
- Links e imagens
- Citações em bloco
- Notas de rodapé
- Matemática (via LaTeX, se habilitado no template)
Personalização
Para personalizar ainda mais o estilo do PDF, você pode modificar os arquivos CSS dentro do diretório da skill. Cada template possui seu próprio arquivo CSS (templates/<nome>.css).
Resolução de Problemas
- Erro "pandoc not found": Instale o pandoc.
- Erro "weasyprint not found": Instale o weasyprint (
pip install weasyprint). - Caracteres CJK não aparecem: Certifique-se de instalar uma fonte CJK (ex.:
fonts-noto-cjk) e use a flag--cjk. - PDF com layout quebrado: Verifique se o Markdown não possui sintaxe muito avançada ou personalizada; alguns recursos podem não ser suportados pelo template escolhido.
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório original.
Licença
MIT