Template: landing _Jumbotron: > # Literate Programming in C#
Produce beautiful, interactive documentation for your C# projects using
[literate programming](https://en.wikipedia.org/wiki/Literate_programming).
Write your documentation inside comments using
[markdown](https://en.wikipedia.org/wiki/Markdown)
and compile it to a fully functional web site that can be published on
[GitHub](https://github.com).
Embed your documentation inside code comments or put it into separate markdown files. All the formatting features of markdown are available to you. Markdig library is used to convert the markdown to HTML. It offers a lot of useful extensions from MathJax formulas to mermaid diagrams.
Generate either raw markdown files or standalone web sites. Using themes and styles you can customize the appearance of the pages. Include a YAML front matter in your source files to pass parameters to the site generator.
A table of contents file defines the structure of your documentation. A TOC file can be automatically generated and updated. The outputted web pages include a navigation pane and navigation buttons to jump from one page to another.
The documentation "weaver" uses Roslyn to parse and analyze your source code. Syntactic and semantic information provided by Roslyn is used for syntax-highlighting, and for adding cross-references and type information to the code blocks. You can jump to the definition of a symbol by clicking it, or inspect its type by hovering over it.
If your code resides under GitHub, you can publish it under
GitHub Pages by turning on a single option in the
project settings. Just generate your documentation under the docs folder,
and turn it on. Done!
Go to the releases page to download the latest version. You can also clone the repository and build the tool from the sources.