DocFX

DocFX is a free, open-source documentation generator for teams building developer documentation into a .NET-based workflow. Its mix of Markdown, .NET and REST API inputs and static output makes it a strong fit for teams that want control over publishing; its native reference coverage is narrower than its broad documentation use.

Overview

DocFX brings authored Markdown together with .NET assemblies, XML code comments and REST API Swagger files. It can produce rendered HTML, JSON models and PDFs, and its static HTML output lands in the _site folder for publishing to services such as GitHub Pages. Teams can also use the Docfx.App NuGet package and .NET APIs to incorporate it into an application.

This makes DocFX useful when documentation generation belongs in a team's own build and publishing process, rather than in a hosted authoring platform. It does require the .NET SDK 8.0 or higher, and other programming languages need a custom API documentation converter.

Key features

DocFX converts XML documentation comments into rendered .NET API pages and can combine reference material with Markdown guides and REST API documentation. The breadth is practical for projects with those inputs, but it should not be mistaken for native reference generation across programming languages.

Markdown parsing uses Markdig for CommonMark-compliant content and supports additional extensions. Built-in templates provide a starting point, including a modern template with dark mode. CSS, JavaScript, Mustache templates and metadata settings allow substantial adaptation; that flexibility is most useful to teams willing to maintain their custom presentation.

For PDF creation, Node.js v20 or higher is required, even though it is otherwise an optional prerequisite. PlantUML diagrams render on a remote server by default, with local rendering as a configurable option. DocFX can generate git links for GitHub, GitLab, Azure Pipelines, AppVeyor, TeamCity and Jenkins, helping connect generated documentation to common project workflows.

Documentation analytics, reader analytics and full-text search are supported. The project is supported by the .NET Foundation.

Pricing

DocFX is free: its DocFX plan costs nothing and is an open-source static site generator. There is no free trial because there is no paid tier to trial. The main cost in practice is the .NET SDK requirement, plus Node.js v20 or higher if PDF creation is needed; PDF is the output that carries the extra prerequisite.

Platforms

DocFX supports API, Linux, macOS, self-hosted and Windows. Static HTML output lets teams publish to static hosting services, while the .NET APIs also support library use within a .NET application.

Who it's for

Choose DocFX if your team works with .NET or REST API reference material, wants to combine it with Markdown, and prefers generating static documentation that it can publish and customize. It is a less direct fit for teams documenting other languages, since they must supply a custom converter, or for teams that want PDF output without adding the required Node.js version.

Pros and cons

• Pros: Combines .NET, REST API and Markdown inputs, so teams can bring reference documentation and authored guides into one generator.
• Pros: Static HTML, JSON and PDF outputs, plus NuGet library use, provide options for publishing or integrating generation.
• Pros: Built-in templates and multiple customization routes let teams shape the documentation site rather than accept a fixed presentation.
• Cons: Native reference generation is limited to .NET and REST APIs; other languages require a custom converter.
• Cons: The .NET SDK 8.0 or higher is required, and PDF creation additionally requires Node.js v20 or higher.
• Cons: PlantUML rendering uses a remote server by default, so teams wanting local rendering must configure that option.

Alternatives

DocPlatform is worth considering for a self-hosted documentation platform with unlimited editors, workspaces and pages on its free Community Edition, rather than a generator centered on .NET and static output.

Fern may fit teams that want a free hosted site with stated limits of 10 team members, 1,000 pages, 250 AI credits per month and 2,000 page generations per month.

Mintlify is another freemium option; its free Starter plan includes five editor seats, a custom domain, web editor, authentication, MCP server and API playground.

Sphinx offers free BSD 2-Clause-licensed software that can be installed locally or self-hosted. VitePress is a free MIT-licensed static site generator that requires Node.js 22 or higher. Writerside has a free plugin for JetBrains IDEs with all standalone-version functionality. 0docs offers a free, MIT-licensed self-hosted documentation platform. GitBook has a free plan for individuals with one free user, unlimited page views and 10 GitBook Agent messages per week.

For broader comparisons, browse Developer Documentation Software, Technical Documentation Software, Documentation Generators and Knowledge base software.

Verdict

DocFX is a solid choice for .NET teams that want to generate and publish customizable static documentation from code, Swagger files and Markdown without paying for the tool. Its strongest reason to choose it is that flexible, build-oriented workflow; look elsewhere if you need native API reference generation for languages beyond .NET and REST APIs, or want a hosted platform rather than a generator.