Categorias

Comentarios para PDF

Gera PDF de docs a partir de comentarios

Extrai comentarios JSDoc e gera PDF.

Entrada: codigo com /** */
Saida: PDF

Exemplos de resultados

1 Exemplos

Exemplo: Doc Comment Docs

Amostra de PDF gerada automaticamente: Source comments rendered as docs PDF

doc-comment-to-pdf-docs-example1.pdf Ver arquivo
Ver parâmetros de entrada
{ "sourceText": "/**\n * Adds two values\n * @param {number} a\n * @param {number} b\n */\nfunction add(a,b){ return a+b }", "docTitle": "Utility Docs", "version": "1.0.0" }

Click to upload file or drag and drop file here

Maximum file size: 10MB Supported formats: text/plain, application/octet-stream

Fatos principais

Categoria
Document Tools
Tipos de entrada
textarea, file, text, number, select, checkbox
Tipo de saída
file
Cobertura de amostras
4
API disponível
Yes

Visão geral

Transforme seus comentários JSDoc diretamente em documentação técnica profissional em formato PDF com esta ferramenta prática de conversão.

Quando usar

  • Quando precisar gerar documentação de API rápida a partir de comentários no código.
  • Para criar manuais técnicos organizados para desenvolvedores ou clientes.
  • Ao preparar relatórios de documentação para revisões de projeto ou entregas de software.

Como funciona

  • Cole seu código fonte contendo comentários JSDoc ou envie o arquivo correspondente.
  • Personalize o título, a versão e as configurações de layout, como margens e tamanho da página.
  • Clique em gerar para processar o conteúdo e baixar seu documento PDF formatado.

Casos de uso

Criação de guias de referência rápida para bibliotecas de código.
Geração de documentação de endpoints de API para equipes de front-end.
Arquivamento de especificações técnicas em formato PDF para histórico de versões.

Exemplos

1. Documentação de API de Utilitários

Desenvolvedor Backend
Contexto
O desenvolvedor precisa compartilhar a documentação de uma nova função de cálculo com a equipe de integração.
Problema
O código está bem comentado, mas não há um documento legível para os outros membros da equipe.
Como usar
Insira o código com JSDoc no campo de texto, defina o título como 'Utility Docs' e a versão como '1.0.0'.
Configuração de exemplo
docTitle: 'Utility Docs', version: '1.0.0', pageSize: 'A4'
Resultado
Um arquivo PDF profissional contendo a descrição da função e seus parâmetros, pronto para ser enviado por e-mail.

Testar com amostras

pdf, text, file

Hubs relacionados

FAQ

Quais formatos de comentário são suportados?

A ferramenta é otimizada para extrair e processar comentários no padrão JSDoc (/** ... */).

Posso personalizar o tamanho da página?

Sim, você pode selecionar entre A4, Letter, Legal ou A5 nas configurações de página.

É possível ajustar as margens do PDF?

Sim, você pode definir margens superiores, inferiores, esquerdas e direitas em milímetros.

O que significa a opção 'Aguardar até'?

Esta configuração define o momento em que o PDF é capturado, garantindo que o conteúdo esteja totalmente carregado antes da geração.

Posso incluir o fundo do documento no PDF?

Sim, a opção 'Imprimir fundo' permite incluir ou remover cores e elementos de fundo no arquivo final.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/doc-comment-to-pdf-docs

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
sourceText textarea Não -
sourceFile file (Upload necessário) Não -
docTitle text Não -
version text Não -
baseFontSize number Não -
pageSize select Não -
landscape checkbox Não -
printBackground checkbox Não -
marginTop number Não -
marginBottom number Não -
marginLeft number Não -
marginRight number Não -
waitUntil select Não -
waitTime number Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/doc-comment-to-pdf-docs para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.

Formato de resposta

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Arquivo: Arquivo

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-doc-comment-to-pdf-docs": {
      "name": "doc-comment-to-pdf-docs",
      "description": "Gera PDF de docs a partir de comentarios",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=doc-comment-to-pdf-docs",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]