Skip to main content

Docnado

A rapid documentation tool to blow you away!!!

Docnado makes it easy to start and maintain a Markdown documentation project.

Features

Docnado renders an adapted Markdown to provide:

  • Embed images, video, YouTube links, external CSV tables, and PDFs.
  • Code highlighting.
  • File download blocks.
  • Lists, checklists, tables, and glossaries.
  • Document defined template selection.
  • Document meta-data.
  • Auto-generated navigation sidebar.
  • Built in command line options to find broken links and orphan images in your documentation.

Accessing Options

  • Output documents as insecure HTML on a localhost.
  • Output documents as PDF files via the HTML server.
  • Create a static set of HTML files that contain the documentation and related resources.

Download

Make sure you have Python 3.6 installed.

python3 -m pip install docnado --upgrade	# install it
docnado # run it

Getting Started


python docnado.py # start a server on localhost:5000

python docnado.py --html # freeze the server into a static site as a set of HTML files
# this will exit with -1 if there was a problem parsing any file

python docnado.py --port # specify a port for docnado to accept requests on

python docnado.py --pdf # generate a set of pdf files for each .md file - won't pull through
# static resource files like with the --html command

python docnado.py --new # copy default templates and sample docs into the working directory
# and update the config too, only if they don't already exist

python docnado.py --new-force # copy default templates and sample docs into the working directory
# and update the config too, this will overwrite any existing docs or
# configs.


python docnado.py --dirs # display all the different directories docnado will use to generate
# the documentation

python docnado.py --find-orphans # display unreferenced media assets in the documentation
python docnado.py --find-broken-links # display external broken links in the documentation