0.0.3 • Published 3 years ago
@browsie/typedoc-plugin-carbodocs v0.0.3
typedoc-plugin-markdown
A plugin for TypeDoc that renders TypeScript API documentation as Markdown.
What it does?
The plugin replaces the default HTML theme with a built-in Markdown theme and exposes some additional options.
Useful if documentation is required to be included in project README files, Wikis and static site generators.
Installation
npm install --save-dev typedoc typedoc-plugin-markdown@nextUsage
Usage is the same as documented at TypeDoc
typedoc --plugin typedoc-plugin-markdownThe --plugin arg is optional (all plugins are loaded by default unless set). Use --plugin none to switch the plugin off.
Options
The following options can be used in addition to relevant TypeDoc options (please note that TypeDoc options specific to the HTML theme will be ignored).
File output options
See File output options for further documentation.
--entryDocumentThe file name of the entry document. Defaults toREADME.md.--symbolsWithOwnFileDetermines which symbols should be written to their own file. Expected valuesnone,allOR Array ofclass,interface,enum,function,var,typeDefaults toall(all symbols exported to an individual file).
UI options
--hideBreadcrumbsDo not print breadcrumbs header. Defaults tofalse.--hideInPageTOCDo not print in-page index items. Defaults tofalse.--hidePageTitleDo not print the page title. Defaults tofalse.--hideHierarchyDo not print reflection hierarchy. Defaults tofalse.--enableLongTitlesDisplay full name including module paths in page titles. Defaults tofalse.
Frontmatter options
See Front matter options for further documentation.
--enableFrontmatterPrepend output with a YAML front matter block. Defaults tofalse.--frontmatterTagsSpecify which file comment tags should be added to front matter variables (as an array).--frontmatterGlobalsSpecify global static variables to be added to all front matter blocks (as an object).
Utility options
--namedAnchorsUse HTML named anchors tags for implementations that do not assign header ids. Defaults tofalse.--baseUrlSpecifies the base url for internal link. If omitted all urls will be relative. Defaults to.