Skip to main content

Create Python API documentation in Markdown format.

Project description

Pydoc-Markdown

Pydoc-Markdown is a tool and library to create Python API documentation in Markdown format based on lib2to3, allowing it to parse your Python code without executing it.

Pydoc-Markdown requires Python 3.6 or newer, however the code that you want to generate API documentation for can be for any Python version.

>> Go to the Documentation

Features

  • Understands multiple doc styles (Sphinx, Google, Pydoc-Markdown)
  • Supports assignment docstrings (#: block before or string literal after the statement)
  • Links references to other documented API objects [WIP]
  • MkDocs, Hugo and Docusaurus integration

Installation

Install Pydoc-Markdown from PyPI:

$ pipx install 'pydoc-markdown>=3.0.0,<4.0.0'

Quickstart (MkDocs)

$ pipx install mkdocs
$ pydoc-markdown --bootstrap mkdocs
$ pydoc-markdown --bootstrap readthedocs
$ pydoc-markdown --server --open

What this does:

  1. Install MkDocs
  2. Create a pydoc-markdown.yml file in the current directory
  3. Create files to render your documentation on readthedocs.org
  4. Render Markdown files from the Python modules/packages in your current working directory and run MkDocs to open a live-preview of the page.

Quickstart (Hugo)

$ pydoc-markdown --bootstrap hugo
$ pydoc-markdown --server --open

What this does:

  1. Create a pydoc-markdown.yml file in the current directory
  2. Render Markdown files from the Python modules/packages in your current working directory and run Hugo to open a live-preview of the page. If Hugo is not available on your system, it will be downloaded automatically.

Copyright © 2020 Niklas Rosenstein

Project details


Download files

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

Files for pydoc-markdown, version 3.10.1
Filename, size File type Python version Upload date Hashes
Filename, size pydoc_markdown-3.10.1-py3-none-any.whl (57.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pydoc-markdown-3.10.1.tar.gz (36.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page