Docsome

Docsome is a documentation framework built around a single Markdown file. It is aimed at people who want their documentation to keep up when they ship quickly, and it presents itself as a way to write one file, run the tool, and get a polished documentation site with minimal setup.

Its main workflow is centered on that one source file: Docsome reads a .md file and automatically handles Vite, routing, and HTML generation. The output is a fully static site with zero client-side routing, rewrites, or redirects. It also generates an /llms.txt file on every build, which is described as making documentation easier to discover and consume by AI agents and RAG pipelines. The built-in feature set also includes an elegant UI, light and dark themes, brand customization through frontmatter, and support for custom alerts.

For writing content, Docsome supports GitHub Flavored Markdown, including tables and task lists. It also provides first-class support for Mermaid diagrams and KaTeX math, and it ships with Tailwind and Basecoat, allowing ready-made UI components to be used directly inside Markdown. Site settings are kept in YAML frontmatter at the top of the Markdown file, with options such as language, title, description, base URL, and logo-related settings, along with additional head scripts and styles.

Docsome ships with a CLI and requires Node.js v20 or later. The command-line interface can build documentation from a single Markdown file and includes a development server that watches the file and reflects changes instantly. The page also shows usage through NPM or Bun commands. Docsome is currently in early alpha.