# docmd Compilador de documentación de código abierto que convierte Markdown en sitios estáticos y salidas legibles por máquinas para lectores, búsquedas, LLM, agentes de programación y herramientas de conocimiento. - Findings24: - Sitio web: - Precios: Freemium - Categorías: Generador de documentación con IA ## ¿Qué es docmd? docmd es un compilador de documentación de código abierto que convierte una carpeta de archivos Markdown en un sitio de documentación estático y en salidas adicionales de documentación legibles por máquinas. Está diseñado para proyectos que necesitan que el mismo contenido fuente sirva tanto a lectores humanos como a sistemas de búsqueda, LLM, agentes de programación y herramientas de conocimiento. La herramienta deriva la navegación del sitio de la estructura de archivos Markdown y no requiere un archivo de configuración, frontmatter ni un framework para su flujo de trabajo básico. Su enfoque orientado a la compilación mantiene el árbol de fuentes y las salidas generadas en un mismo flujo de compilación, en lugar de requerir pilas separadas para el sitio web y el conocimiento para IA. Además del sitio web, docmd puede generar un índice de búsqueda sin conexión, `llms.txt` y `llms-full.txt`, salidas en Open Knowledge Format (OKF), sitemap y metadatos SEO, `robots.txt`, metadatos de Open Graph, una interfaz MCP para agentes de IA y contexto para asistentes de IA. La fuente describe estos elementos como salidas de la compilación de documentación. ## ¿Qué puede hacer docmd? ### Compilación basada en Markdown Indica a docmd una carpeta de archivos Markdown y compila el árbol de fuentes en documentación. La configuración básica no requiere un archivo de configuración, frontmatter ni un framework. ### Sitio de documentación estático generado La compilación produce un sitio estático con navegación generada a partir de la estructura de archivos fuente, por lo que el resultado es adecuado para desplegarse en servicios de alojamiento estático. ### Salidas de búsqueda y descubrimiento docmd puede generar un índice de búsqueda sin conexión, además de sitemap, metadatos SEO, robots.txt y metadatos de Open Graph para el descubrimiento y uso compartido del sitio. ### Formatos para IA y conocimiento La misma fuente puede producir \`llms.txt\`, \`llms-full.txt\`, salidas en Open Knowledge Format y contexto para asistentes de IA destinados a flujos de trabajo de documentación orientados a máquinas. ### Acceso de agentes mediante MCP La canalización de salidas documentada incluye una interfaz MCP para agentes de IA, lo que permite que el proyecto de documentación exponga una interfaz orientada a agentes, además de páginas web y archivos. ### Flujos de trabajo locales, mediante paquetes y contenedores El repositorio documenta la ejecución mediante npx, la instalación global con npm o pnpm y la imagen de Docker ghcr.io/docmd-io/docmd. El servidor de desarrollo utiliza el puerto 3000 en el ejemplo de inicio rápido. ## Casos de uso ### Publicar documentación de proyectos Mantén archivos Markdown en una carpeta de fuentes y compílalos en un sitio estático navegable para usuarios que necesiten leer documentación de productos o proyectos en un navegador. ### Crear documentación para recuperación automática Utiliza las salidas generadas \`llms.txt\`, \`llms-full.txt\` o Open Knowledge Format cuando la misma documentación también deba ser consumida por LLM, sistemas de conocimiento orientados a RAG u otras herramientas automatizadas. ### Admitir flujos de trabajo con agentes de programación Utiliza la interfaz MCP documentada y las salidas de contexto para asistentes de IA para poner la documentación del proyecto a disposición de agentes de programación junto con el sitio orientado a lectores humanos. ### Desarrollar y previsualizar documentación localmente Ejecuta el comando de desarrollo sobre una carpeta Markdown, abre el servidor local en el puerto 3000 y realiza iteraciones en la fuente antes de crear una compilación para despliegue. ### Desplegar una compilación de documentación estática Ejecuta el comando de compilación y publica el sitio estático generado mediante un servicio de alojamiento estático compatible o un servidor autogestionado como NGINX o Caddy. ## Preguntas frecuentes ### ¿Qué utiliza docmd como fuente? docmd utiliza una carpeta de archivos Markdown. En el flujo de inicio rápido básico, la navegación se genera a partir de la estructura de archivos y no se requiere un archivo de configuración, frontmatter ni un framework. ### ¿Qué genera docmd además de un sitio web? Las salidas documentadas incluyen un índice de búsqueda sin conexión, \`llms.txt\`, \`llms-full.txt\`, salidas en Open Knowledge Format, sitemap y metadatos SEO, \`robots.txt\`, metadatos de Open Graph, una interfaz MCP para agentes de IA y contexto para asistentes de IA. ### ¿Cómo pruebo docmd localmente? El inicio rápido utiliza \`npx @docmd/core dev\` apuntando a una carpeta Markdown y después abre \`http://localhost:3000\`. La fuente también documenta la instalación global con npm o pnpm. ### ¿Se puede desplegar el sitio generado en un servicio de alojamiento estático? Sí. El comando de compilación documentado es \`npx @docmd/core build\`. La fuente menciona Vercel, Cloudflare Pages, Netlify, GitHub Pages, S3, NGINX, Caddy y otros servicios de alojamiento estático como opciones de despliegue. ### ¿docmd requiere Node.js? La documentación de inicio rápido del repositorio indica que docmd requiere Node.js 20 o posterior. También se documenta una imagen de Docker como método de ejecución alternativo. ## Datos rápidos - **Categoría**: Herramienta de documentación para desarrolladores de código abierto - **Formato de fuente**: Archivos Markdown en una carpeta - **Requisito de ejecución**: Node.js 20 o posterior - **Opciones de ejecución**: npx, instalación global con npm o pnpm, o Docker - **Salidas principales**: Sitio estático, índice de búsqueda, contexto para IA y formatos de conocimiento - **Licencia**: MIT