docmd

Qué es docmd en realidad

docmd (github.com/docmd-io/docmd) es una CLI de Node que convierte una carpeta de Markdown en un sitio de documentación. `npx @docmd/core dev` funciona en cualquier carpeta que contenga Markdown y sirve en localhost sin archivo de configuración, sin exigir frontmatter y con la navegación derivada de tu estructura de directorios; `npx @docmd/core build` escribe un sitio estático que puedes alojar donde quieras. La licencia es un MIT sencillo en el archivo LICENSE del repositorio, el proyecto arrancó en mayo de 2025 y el historial de versiones es constante en lugar de a rachas — de la 0.8.15 del 15 de julio de 2026 a la 0.9.4 del 23 de agosto de 2026, con 14 incidencias abiertas en el momento de la captura.

• Arranca sin nada configurado No hace falta ningún archivo de configuración. Existe un `docmd.config.json` para cuando quieras fijar un título, una URL canónica o directorios distintos de origen y salida, y puede escribirse en TypeScript o JavaScript si necesitas valores dinámicos.
• Los artefactos para IA son plugins del núcleo, no añadidos Los plugins `llms`, `okf`, `search`, `seo` y `sitemap` vienen activados por defecto, así que los archivos de contexto y el sitemap salen de una compilación normal y no de un paso que alguien deba recordar.
• Trae la migración incluida `docmd migrate` convierte una instalación existente de Docusaurus, VitePress, MkDocs o Starlight, lo cual importa sobre todo porque significa que probarlo no empieza por reescribirlo todo.
• Trata idiomas y versiones como compilaciones de primera clase Las compilaciones multiidioma producen un índice de búsqueda por idioma, archivos de contexto por idioma y etiquetas hreflang, y las versiones de la documentación son nativas en lugar de un plugin. Si ya traduces tu sitio, esta es la parte que decide si encaja.
• Comprueba la versión de Node en el paquete, no en el README El README indica Node.js 18 o superior; el paquete publicado `@docmd/core` declara `engines.node >= 20.0.0`. En una máquina que siga con la 18, será la instalación la que te lo diga, así que cuenta con la 20.

También hay una parte alojada, y conviene saber dónde cae la línea antes de adoptarlo. El plugin de asistente de IA hace chat con recuperación sobre tu propia documentación usando tu clave de API o un modelo local; el Cloud Relay de cloud.docmd.io existe para que un sitio puramente estático pueda ejecutar ese asistente sin que tú levantes un backend. El compilador y todos los artefactos de abajo están en el repositorio MIT — el relay es la comodidad alojada opcional, que es la forma open core en miniatura.

Los cuatro artefactos para máquinas, y qué consume cada uno

Esta es la razón por la que esa lista vale más de lo que parece. Publicamos `llms.txt` y `llms-full.txt` para AgentCeres — el Director de Crecimiento con IA, en agentceres.com — y escribimos ambos a mano. Se desviaron. Los archivos listaban roles internos que un cliente no puede seleccionar y una tabla de precios por puesto que describía un modelo que nunca hemos vendido. Nadie lo detectó durante semanas, porque las comprobaciones que vigilan nuestros textos de marketing recorren los directorios de código de la aplicación, y esos dos archivos viven en una carpeta estática `public/` que ninguna de ellas lee. Un archivo de contexto generado elimina esa clase entera de error por construcción — no porque generar sea más listo, sino porque ya no queda una segunda copia que pueda quedarse obsoleta.

Dónde encaja cuando intentas que te encuentren

La documentación es una de las pocas cosas que escribe un equipo pequeño y que un motor de respuestas puede usar directamente: es concreta, está fechada y describe un producto que nadie más puede describir con tanta exactitud. Eso la convierte en buena materia prima para la optimización para motores generativos, y docmd reduce a casi cero el coste de hacerla recuperable. Si tu pregunta es la más amplia de cómo conseguir que ChatGPT cite tu startup, esto es una entrada de ese problema, no su respuesta.

Ten claro el límite, porque es fácil sobrevalorarlo. Emitir un archivo de contexto abarata la recuperación de tu documentación; no hace que un modelo te elija, y ningún paso de compilación puede hacerlo. Además solo cubre la documentación. Tu página de precios, tus páginas comparativas y tus landings son otro corpus con otros problemas, y suelen ser las que reciben de verdad la pregunta de quien compra. Si lo que necesitas es un sitio de documentación y no la mitad legible por máquina, Docusaurus es la opción más convencional y la tratamos por separado.

El orden honesto para quien funda una empresa: escribe la documentación porque tus usuarios la necesitan, quédate con los archivos de contexto como subproducto gratuito y trata el tráfico como un efecto de segundo orden que puede tardar meses en aparecer. Publicar los archivos es una opción de compilación. Merecer la cita es el trabajo, y esa parte sigue siendo escribir — que es donde AgentCeres redacta contigo y una persona aprueba todo lo que sale.