typedoc-plugin-markdown
Please note this pre-release version may contain breaking changes within the same semantic version.
A plugin for TypeDoc that renders TypeScript API documentation as Markdown.
Contents
What does it do?
By default, TypeDoc will render API documentation as a webpage, e.g. HTML files.
The plugin replaces the default HTML theme with a built-in Markdown theme and exposes some additional options. This is useful if documentation is required to be included in project README files, Wikis and static site generators.
Installation
npm install typedoc typedoc-plugin-markdown@next --save-dev
Usage
Plugins are loaded by using the plugin
configuration option:
typedoc --plugin typedoc-plugin-markdown
Please see https://typedoc.org/options/configuration.
Options
TypeDoc options
All of TypeDoc's Configuration, Input and Organization options are respected as they are executed at the conversion phase of the project.
TypeDoc's Output options are on the whole only relevant to the HTML theme and the majority are ignored by this plugin. Supported Output options are out
, cleanOutputDir
.
Plugin Options
This plugin exposes additional options. Please see Options Guide for detailed usage.
File output options
Structure and formatting options
Utility options
Contributing
Contributions and suggestions are welcome. Contributing guidelines coming soon.
License
MIT