XMLDoc2Markdown

July 25, 2024 ยท View on GitHub

Tool to generate markdown from C# XML documentation.

Build Status Nuget Quality Gate Status

How to use

Install tool

dotnet tool install -g XMLDoc2Markdown

Generate documentation

dotnet xmldoc2md <src> [options]
ArgumentDescription
<src>DLL source path
OptionDescription
-o, --output <output>Output directory
--index-page-name <index-page-name>Name of the index page [default: index]
--examples-path <examples-path>Path to the code examples to insert in the documentation
--github-pagesRemove '.md' extension from links for GitHub Pages
--gitlab-wikiRemove '.md' extension and './' prefix from links for gitlab wikis
--back-buttonAdd a back button on each page
--member-accessibility-level <internal|private|protected|public>Minimum accessibility level of members to be documented. [default: protected]
--structure <flat|tree>Documentation structure. [default: flat]
--versionShow version information
-?, -h, --helpShow help and usage information

Example

dotnet xmldoc2md Sample.dll --output docs --github-pages --back-button

See complete documentation here.