typedoc-plugin-docusaurus

A plugin for TypeDoc that exposes themes and options for rendering markdown for Docusaurus

Getting started

Installation

npm install --save-dev typedoc typedoc-plugin-docusaurus

How to use

The plugin provides an additional markdown theme.

node_modules/.bin/typedoc --theme markdown

Additional arguments

The plugin exposes the following additional arguments:

• --mdFlavour<github|bitbucket>
  Specifies the markdown rendering engine. Defaults to github.
• --mdHideSources
  Suppress sources from output
• --mdSourceRepo<path.to.repo>
  The source repo to use for source file linking. Will be ignored on github flavoured projects.
  For bitbucket use: https://bitbucket.org/owner/repository_name.
  

Example output

The following DocComments:

/**
 * This is a function with multiple arguments and a return value.
 * @param paramZ  This is a string parameter.
 * @param paramG  This is a parameter flagged with any.
 */
 
export function functionWithArguments(paramZ:string, paramG:any):number {
    return 0;
}

Will generate the following output:

► functionWithArguments(paramZ: string, paramG: any): number

Defined in functions.ts:41

This is a function with multiple arguments and a return value.

Parameters:

Param	Type	Description
paramZ	string	This is a string parameter.
paramG	any	This is a parameter flagged with any.

Returns: number

Samples

Browse some mocked samples to view further examples of generated output.

Acknowledgements

• This is a quick and dirty fork of Thomas Grey's typedoc-plugin-markdown with a few minor edits required to flatten the output and make it suitable for direct use in Docusaurus. When we have more time we will come back and make this a parameter switch and submit a pull request to typedoc-plugin-markdown. Until then, feel free to submit pull requests to this one if it gets out of date with upstream.

• He thanked kimamula's typedoc-markdown-theme for the inspiration behind this project.