Categorías

Comentarios a PDF

Genera PDF de docs desde comentarios de codigo

Extrae comentarios JSDoc y crea PDF de documentacion.

Entrada: codigo con /** */
Salida: PDF

Resultados de ejemplo

1 Ejemplos

Ejemplo: Doc Comment Docs

Muestra PDF generada automaticamente: Source comments rendered as docs PDF

doc-comment-to-pdf-docs-example1.pdf Ver archivo
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

Datos clave

Categoría
Document Tools
Tipos de entrada
textarea, file, text, number, select, checkbox
Tipo de salida
file
Cobertura de muestras
4
API disponible
Yes

Resumen

Esta herramienta permite convertir automáticamente los comentarios JSDoc de tu código fuente en un documento PDF profesional, facilitando la creación de manuales técnicos y documentación de API sin esfuerzo adicional.

Cuándo usarlo

  • Cuando necesites generar documentación técnica rápida a partir de comentarios en el código.
  • Para crear manuales de API legibles para equipos que no acceden directamente al repositorio.
  • Al preparar entregables de proyectos que requieren documentación formal en formato PDF.

Cómo funciona

  • Pega tu código fuente con comentarios JSDoc en el área de texto o sube el archivo correspondiente.
  • Configura el título del documento, la versión y los ajustes de formato como el tamaño de página y los márgenes.
  • Ajusta las opciones de renderizado, como el tamaño de fuente y la orientación, para personalizar el estilo visual.
  • Haz clic en generar para procesar el código y descargar el archivo PDF resultante con tu documentación estructurada.

Casos de uso

Generación de guías de referencia rápida para desarrolladores junior.
Creación de documentación de API para clientes externos sin exponer el código fuente completo.
Archivado de especificaciones técnicas en formato PDF para auditorías de proyectos.

Ejemplos

1. Documentación de API para funciones de utilidad

Desarrollador Backend
Contexto
El equipo necesita una guía rápida de las funciones de utilidad compartidas para los nuevos integrantes.
Problema
La documentación está dispersa en múltiples archivos de código y no es fácil de consultar.
Cómo usarlo
Copia las funciones principales con sus bloques JSDoc en el campo de texto y establece el título como 'Manual de Utilidades'.
Configuración de ejemplo
docTitle: 'Manual de Utilidades', version: '1.0.0', pageSize: 'A4'
Resultado
Un archivo PDF limpio que lista cada función, sus parámetros y descripciones, listo para ser compartido.

Probar con muestras

pdf, text, file

Hubs relacionados

Preguntas frecuentes

¿Qué formatos de archivo admite?

Puedes ingresar el código directamente en el área de texto o subir archivos de texto plano (.txt) o archivos de código fuente.

¿Es necesario que los comentarios sigan un formato específico?

Sí, la herramienta está optimizada para extraer comentarios que utilicen la sintaxis estándar JSDoc (/** ... */).

¿Puedo personalizar el diseño del PDF?

Sí, puedes ajustar el tamaño de página, la orientación, los márgenes y el tamaño base de la fuente desde el panel de configuración.

¿Qué sucede si mi código es muy extenso?

La herramienta procesará el contenido y generará un PDF paginado según el tamaño de página seleccionado (A4, Letter, etc.).

¿Se incluye el fondo del código en el PDF?

Sí, la opción 'Imprimir fondo' está activada por defecto para asegurar que el formato visual se mantenga en el documento final.

Documentación de la API

Punto final de la solicitud

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

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
sourceText textarea No -
sourceFile file (Subida requerida) No -
docTitle text No -
version text No -
baseFontSize number No -
pageSize select No -
landscape checkbox No -
printBackground checkbox No -
marginTop number No -
marginBottom number No -
marginLeft number No -
marginRight number No -
waitUntil select No -
waitTime number No -

Los parámetros de tipo archivo necesitan ser subidos primero vía POST /upload/doc-comment-to-pdf-docs para obtener filePath, luego pasar filePath al campo de archivo correspondiente.

Formato de respuesta

{
  "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)"
}
Archivo: Archivo

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

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

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Soporte para enlaces de archivos URL o codificación Base64 para parámetros de archivo.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]