npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@terwer/typedoc-plugin-markdown

v4.0.0-next.11

Published

A plugin for TypeDoc that enables TypeScript API documentation to be generated in Markdown.

Downloads

23

Readme

typedoc-plugin-markdown

A plugin for TypeDoc that renders TypeScript API documentation as Markdown.

npm Build Status

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

Please note this pre-release version may contain breaking changes within the same semantic version.

TypeDoc and Prettier are both required peer dependencies.

npm install typedoc-plugin-markdown@next --save-dev

Usage

typedoc --plugin typedoc-plugin-markdown

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 and content organization

  • --outputFileStrategy Determines how output files are generated. Allowed values modules (all symbols hoisted to a single modules file) or members (each symbol exported to a seperate file). Default value members.
  • --entryDocument The file name of the entry document. Default value README.md.
  • --includeFileNumberPrefixes Prefixes generated files and folders with number prefixes. This is useful for auto sidebar generation. Defaults to false.
  • --excludeGroups By default members are grouped by kind (eg Classes, Functions etc). This option excludes such groupings so all members are rendered and sorted at the same level. Defaults to false.

Please see File output and content organization for further documentation.

UI options

  • --hidePageHeader Do not print the page header. Defaults to false.
  • --hideBreadcrumbs Do not print breadcrumbs. Defaults to false.
  • --hideInPageTOC Do not print in-page index items. Defaults to false.
  • --hidePageTitle Do not print the page title. Defaults to false.
  • --hideKindTag Do not print the kind tag identifiers for symbols. Defaults to false.
  • --hideHierarchy Do not print reflection hierarchy. Defaults to false.
  • --indexPageTitle The title of the main index / modules page. If not set will default to the project name.
  • --indentifiersAsCodeBlocks Format signature and declaration identifiers in code blocks. Note if true references will not be linked. Defaults to false.
  • --propertiesFormat Specify the render style of properties groups for interfaces, classes and type literals. Expected values [list, table]. Defaults to list.
  • --enumMembersFormat Specify the render style of Enum members. Expected values [list, table]. Defaults to list.
  • --typeDeclarationFormat Specify the render style for type declaration members. Expected values [list, table]. Defaults to list.

Utility options

  • --baseUrl Specifies the base url for internal link. If omitted all urls will be relative. Defaults to .
  • --anchorFormat The anchor style to use when linking to internal symbols. Expected values [lowercase, slug, none]. Defaults to lowercase.
  • --anchorPattern The anchor pattern to use when linking to internal symbols. e.g customprefix-{{anchor}}.
  • --namedAnchors Use HTML named anchor tags for implementations that do not assign header ids. Defaults to false.

Frontmatter

If frontmatter is required for adding further metadata please use typedoc-plugin-frontmatter

Output formatting (Prettier)

Generated Markdown is now parsed with Prettier which is backed by the remark-parse package. Parsing documents with Prettier has several benefits:

  • Produces a consistent format.
  • Remove unnecessary escape characters.
  • Formats code blocks inside comment fenced blocks.

Any prettier configuration files discovered will be passed as options to the parser.

Further Documentation

License

MIT