TypeDoc
What it is
TypeDoc is a free documentation generator that converts comments in TypeScript source code into HTML documentation or a JSON model. It builds from project exports and follows re-exports, so members declared in other files can appear in the generated output. It extracts TSDoc and JSDoc tags, accepts Markdown in comments, and highlights fenced code blocks with Shiki. HTML and JSON are included output formats; Markdown requires a plugin such as typedoc-plugin-markdown. TypeDoc includes a default theme, and plugins can add themes or modify conversion, symbol organization, and display. Custom CSS or JavaScript can further change generated pages. Options can be read from an options file, package.json, or tsconfig.json. For npm monorepos, documentation for multiple packages can be combined into one site using the packages entry-point strategy. TypeDoc runs on Node.js, is distributed through npm, and parses code with the TypeScript compiler in a way similar to tsc. It supports the current Node.js LTS version or newer, and TypeDoc 0.28 is maintained for TypeScript versions 5.0 through 5.8. The project identifies its license as Apache-2.0 and invites issues or pull requests on GitHub.
For and against
For
- Free and Apache-2.0 licensed
- Generates HTML and JSON output
- Supports TSDoc, JSDoc, and Markdown comments
- Can combine npm package documentation for monorepos
- Themes and plugins can customize output
Against
- Markdown output requires a plugin
- Requires Node.js
- Global installation can cause plugins and themes to use a separate TypeDoc installation
The verdict
TypeDoc turns TypeScript comments into structured documentation, with built-in HTML and JSON outputs and plugins for additional formats and customization. Its Node.js requirement and warning about global installation are worth considering when setting up a project.
Who it suits
TypeDoc suits TypeScript project maintainers who want to generate documentation from source comments and project exports. Its plugin and theme options also suit teams that need to adjust the output or add Markdown generation.
Plans and prices
Free and open source
Documentation generator for TypeScript projects · Apache-2.0 license
Read 9 Oct 2026 · github.com
On the record
- Code highlighting
- TypeDoc supports fenced code blocks and uses Shiki for syntax highlighting.typedoc.org · read 9 Oct 2026
- Comment formats
- TypeDoc extracts TSDoc/JSDoc tags and supports Markdown in comments.typedoc.org · read 9 Oct 2026
- Configuration
- Options can be set through command-line arguments or configuration files.typedoc.org · read 9 Oct 2026
- Customization
- Themes can change the look and feel of generated documentation, and plugins can add themes.typedoc.org · read 9 Oct 2026
- Entry points
- TypeDoc can infer entry points from package.json or accept entry points specified manually.github.com · read 9 Oct 2026
- Exports
- It generates documentation based on project exports and follows re-exports to document members declared in other files.typedoc.org · read 9 Oct 2026
- Extensibility
- TypeDoc is extensible through a plugin API, and plugins can add features such as Markdown output.typedoc.org · read 9 Oct 2026
- Installation
- TypeDoc runs on Node.js and is available as an npm package.github.com · read 9 Oct 2026
- Integrations
- The GitHub Pages option generates a .nojekyll file, and source links can use GitHub or Bitbucket remotes.typedoc.org · read 9 Oct 2026
- License
- The TypeDoc repository identifies its license as Apache-2.0.github.com · read 9 Oct 2026
- License and security
- The GitHub repository identifies the project as Apache-2.0 licensed and links to a security policy.github.com · read 9 Oct 2026
- Monorepos
- For npm package codebases, TypeDoc can build documentation for each package and merge results into a single site using entryPointStrategy set to packages.github.com · read 9 Oct 2026
- Notable limitation
- The documentation warns that global installation can cause plugins and themes to use a separate TypeDoc installation and break.typedoc.org · read 9 Oct 2026
- Output formats
- The default output is HTML, and TypeDoc can also write a JSON model describing the project.github.com · read 9 Oct 2026
- Plugin support
- Plugins can modify project conversion, symbol organization, and display, and are loaded with the --plugin flag.typedoc.org · read 9 Oct 2026
- Purpose
- TypeDoc converts comments in TypeScript source code into HTML documentation or a JSON model.typedoc.org · read 9 Oct 2026
- Runtime
- TypeDoc requires Node.js and supports the current LTS version or newer.typedoc.org · read 9 Oct 2026
- Security
- The GitHub repository links to a security policy, but the opened repository page does not state specific security certifications or compliance claims.github.com · read 9 Oct 2026