Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Generate markdown from python docstrings.

Project Description

This is a Concept Only

Simpledoc is tool to create markdown (.md) files from your projects docstrings. The only requirments are to have a config file and and simpledoc installed. Then running the command will traverse your project modules and pull all the docstrings.

Test Installation

sudo pip install -i simpledoc

Typical Usage

document_name =

include_classes = False
include_functions = False
document_name =

Then run the simpledoc command.

$ --config=my_config.ini

The output will be a file with all the docstrings in the modules controllers.api and services.

Command Line Options

The following are the command line options:

  • –config=”file” : Required. File where the config settings are for this project.

Configuration Options

The following are settings that can be used for each section of a config file.

  • include_module: Include the docstring for the module.
  • include_classes: Include the docstring for each class.
  • include_class_methods: Include the docstring for each class method
  • include_functions: Include the docstring for each function in the module.
  • document_name: the path and file name of where the markdown file should be stored.
  • black_list: is a list of packages or modules to be ignored.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.3 kB) Copy SHA256 Hash SHA256
Source None Jul 28, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting