typescript-documentation

Generate markdown API documentation directly from TypeScript source code.

Documenting variables

Example input:

/**
 * Simple variable description
 * line 2
 * @see {@link https://test.url.1|Example url 1}
 * @see {@link https://test.url.2|Example url 2}
 * @example
 * example 1 line 1
 * example 1 line 2
 * @example
 * example 2 line 1
 * example 2 line 2
 */
export const simpleVariable: number = 1;

Example output:

simpleVariable

Simple variable description line 2

TYPE

number

EXAMPLES

example 1 line 1
example 1 line 2

example 2 line 1
example 2 line 2

SEE ALSO

• Example url 1
• Example url 2

Documenting functions

Example input:

/**
 * Simple function description
 * line 2
 * @see {@link https://test.url.1|Example url 1}
 * @see {@link https://test.url.2|Example url 2}
 * @example
 * example 1 line 1
 * example 1 line 2
 * @example
 * example 2 line 1
 * example 2 line 2
 */
export function simpleFunction(a: string, b: number): string {
  return a + b;
}

Example output:

simpleFunction(a, b)

Simple function description line 2

PARAMETERS

• a: string
• b: number

RETURNS

string

EXAMPLES

example 1 line 1
example 1 line 2

example 2 line 1
example 2 line 2

SEE ALSO

• Example url 1
• Example url 2

Documenting classes

Example input:

/**
 * Simple class description
 * line 2
 * @see {@link https://test.url.1|Example url 1}
 * @see {@link https://test.url.2|Example url 2}
 * @example
 * example 1 line 1
 * example 1 line 2
 * @example
 * example 2 line 1
 * example 2 line 2
 */
export class SimpleClass {
  /**
   * simpleMethod1 description
   * line 2
   * @see {@link https://test.url.3|Example url 3}
   * @see {@link https://test.url.4|Example url 4}
   * @example
   * example 3 line 1
   * example 3 line 2
   * @example
   * example 4 line 1
   * example 4 line 2
   */
  public simpleMethod1(): void {
    return;
  }

  /**
   * simpleMethod2 description
   * line 2
   */
  public simpleMethod2(a: string, b: number): string {
    return a + b;
  }
}

Example output:

SimpleClass

Simple class description line 2

EXAMPLES

example 1 line 1
example 1 line 2

example 2 line 1
example 2 line 2

SEE ALSO

• Example url 1
• Example url 2

simpleClass.simpleMethod1()

simpleMethod1 description line 2

RETURNS

void

EXAMPLES

example 3 line 1
example 3 line 2

example 4 line 1
example 4 line 2

SEE ALSO

• Example url 3
• Example url 4

simpleClass.simpleMethod2(a, b)

simpleMethod2 description line 2

PARAMETERS

• a: string
• b: number

RETURNS

string

Documenting types

Example input:

/**
 * Simple type description
 * line 2
 * @see {@link https://test.url.1|Example url 1}
 * @see {@link https://test.url.2|Example url 2}
 * @example
 * example 1 line 1
 * example 1 line 2
 * @example
 * example 2 line 1
 * example 2 line 2
 */
export type SimpleType = {
  a: string;
  b: number;
};

Example output:

SimpleType

Simple type description line 2

PROPERTIES

• a: string
• b: number

EXAMPLES

example 1 line 1
example 1 line 2

example 2 line 1
example 2 line 2

SEE ALSO

• Example url 1
• Example url 2

Documenting enumerations

Example input:

/**
 * Simple enumeration description
 * line 2
 * @see {@link https://test.url.1|Example url 1}
 * @see {@link https://test.url.2|Example url 2}
 * @example
 * example 1 line 1
 * example 1 line 2
 * @example
 * example 2 line 1
 * example 2 line 2
 */
export enum SimpleEnum {
  ONE,
  TWO
}

Example output:

SimpleEnum

Simple enumeration description line 2

POSSIBLE VALUES

• ONE
• TWO

EXAMPLES

example 1 line 1
example 1 line 2

example 2 line 1
example 2 line 2

SEE ALSO

• Example url 1
• Example url 2