DocFX vs Documentation.AI

DocFX is a free static site generator for technical documentation. It builds documentation from .NET assemblies, XML code comments, REST API Swagger files and Markdown, and can produce rendered HTML pages, JSON models or PDFs. Static HTML output is placed in the `_site` folder for publication to hosting services such as GitHub Pages. DocFX can also be used as a NuGet library through the `Docfx.App` package and .NET APIs. It parses CommonMark-compliant Markdown with Markdig and supports additional extensions. Built-in templates include a modern option with dark mode and customization settings; users can also customize templates with CSS, JavaScript, Mustache templates and metadata. DocFX can generate git links for GitHub, GitLab, Azure Pipelines, AppVeyor, TeamCity and Jenkins. It requires .NET SDK 8.0 or higher. Node.js v20 or higher is optional generally, but required to create PDFs. Native reference documentation generation covers .NET and REST APIs; other languages need a custom API docs converter. PlantUML diagrams use a remote server by default, with local rendering available as a setting.

Documentation.AI combines an AI documentation agent, review workflows, publishing, and AI access for technical documentation. Teams can write in a visual web editor or use Markdown and MDX in Git repositories with pull-request previews. OpenAPI specifications generate API reference pages with request and response examples plus a live playground. Agent and workflow changes arrive as drafts or commits for review instead of publishing automatically. The platform includes an in-document assistant with cited answers, a Reader MCP server, and generated llms.txt. GitHub, GitLab, Jira, and Confluence can supply context, while analytics and chat integrations include Google Analytics 4, PostHog, Intercom, and Crisp. Documentation may be public, password-protected, or private with JWT or OAuth 2.0; SAML/OIDC SSO and SCIM are Enterprise features. AI work pauses when credits run out until the next cycle or a top-up, with no overage billing stated. Starter is free; Standard costs $55 a month billed yearly, and Pro costs $159 a month billed yearly.