/DocFxMarkdownGen

Docusaurus Markdown generator using DocFX.

Primary LanguageC#MIT LicenseMIT

DocFxMarkdownGen

Generates documentation for a .NET library in Markdown intended for Docusaurus using docfx.

Installation

dotnet tool install -g DocFxMarkdownGen
# now installed as "dfmg", use with "dotnet dfmg" or just "dfmg" if tools are in PATH

Usage

By default dfmg takes it's config from config.yaml, you can override the file using the DFMG_CONFIG environment variable.

outputPath: /home/jan/whatever/docs/api
yamlPath: /home/jan/gen/api
  • outputPath is the path where the generated documentation will be placed, it is always wiped.
  • yamlPath is the path where the .yml files generated by docfx metadata are placed, probably the api directory where your docfx.json file is.
  • indexSlug is the slug of the index page, defaults to /api.

Example sites

For creating your own site, head to dfmg-template.

This project is still very new, if you find an issue in the markdown generated, please open an issue!