Skip to content
/ CsToMd Public

Visual Studio extension and Dotnet CLI Tool to generate the Markdown Docs from the C# Tests keeping your Docs and Tests in sync!

License

Notifications You must be signed in to change notification settings

dadhi/CsToMd

Repository files navigation

CsToMd

Visual Studio extension to generate a Markdown .md documentation file from the C# .cs file stripping the special symbol comments.

This VSIX extension for Visual Studio 2019 contains a CustomTool File Generator, which generates a markdown file from the .cs file by stripping the comments /*md, md*/, and //md.

The tool helps to turn your C# file with markdown comments into documentation file with runnable examples and what not.

How it looks

screen1

The result

screen1

How to use

  • Clone this repo, compile CsToMd project, find the CsToMd.vsix in output and install it.
    Or simply install a vsix extension from the release.
  • In properties of your .cs file, set the CustomTool property to CsToMd.
  • Save the .cs file with /*md and md*/ comments in it (or without - it will work too).
  • Check the generated .md file under the .cs file in Solution Explorer

Play with the example project CsToMdTest in this repo to see how it works.

That's all for now.. Stay tuned ;-)