Natural Docs

Natural Docs lets you document code written in any of 21 programming languages, plus it can be easily extended for more so whatever you use, it can too. And if your project uses multiple languages, no problem! It will all be included in the same set of documentation.

And Plain English Too

Natural Docs also speaks your other language... English! Its comments are designed to be very natural and readable so they're just as usable in the source code as they are in the generated documentation. No weird syntax or tags scattered everywhere.

Pretty, Powerful HTML

Natural Docs' generated documentation is pretty and powerful, with three independently scrolling panels, dynamic menus, search, and pop-up summaries when you hover over links. All its features work wherever you put it, be it a web server, a network share, or just opened from your hard drive.

So Let's Get Started!

If you're new to Natural Docs be sure to read our Getting Started guide and we'll have you up and running in no time. If you've been using Natural Docs 1.5, check out our tour of What's New in 2.0!

About

Guides

Community

Contribute

News

Get notified of new releases via e-mail

or RSS

Natural Docs 2.1 development release 2

April 11th, 2020

I got some more improvements for you:

Better support for Python. Added support for function @decorators and improved syntax highlighting all around.
Basic support for Lua. It's now included out of the box. It has special code to support its --[==[ comment format. It also permits using ]]-- as a closing comment symbol even though that's technically a closing comment followed by a line comment. Some people like it for symmetry.
Performance improvements. Updated the embedded SQLite from 3.13.0 to 3.31.1, which shaved 10% off the parsing and link resolving stages.
More behind the scenes refactoring. As described in development release 1, I'm refactoring some of the change management code to make it easier to work with and clear the way for adding image support. You shouldn't notice any changes, though this is a development release to make sure that's true.
Other minor tweaks. Updated NUnit from 2.6.2 to 3.11.1. Updated the application icon. Fixed a bug when building Natural Docs to run SQLite in UTF-16 mode instead of UTF-8 mode. Testing showed it was a wash, with speedups in some places being cancelled out by slowdowns in others. The default continues to be UTF-8 since it takes up less space and memory.

Discuss

Natural Docs 2.1 development release 1

March 6th, 2020

Older News...