---
id: griffe2md
version: "1.5.0"
license: ISC
license_treatment: permissive
maintenance: active
---

# griffe2md — Output API docs to Markdown using Griffe.

License: permissive · Maintenance: active · Downloads: 276.9K/mo

## What it is and what it does

griffe2md is a command-line tool that converts Python package API documentation into Markdown files. It uses Griffe, a static analysis library, to parse your package's structure and docstrings, then renders them as formatted Markdown suitable for documentation sites or repositories. The tool supports multiple docstring styles (configurable via pyproject.toml or griffe2md.toml) and can output to stdout or directly to a file.

You run it by pointing it at a package name or folder path, and it generates structured Markdown with your API's classes, functions, and their documentation. It's designed for developers who want to maintain API docs in Markdown format without manually writing or updating them, integrating easily into documentation workflows alongside tools like mdformat for consistent formatting.

Use it for:

- Generate API reference documentation for a Python package to include in a README or docs site
- Automate API doc generation in CI/CD pipelines to keep docs in sync with code changes
- Convert existing docstrings to Markdown format for migration to a new documentation system
- Create Markdown API docs for packages that use Sphinx-style docstrings without needing Sphinx itself

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates Markdown API documentation from Python packages using Griffe's static analysis, with support for multiple docstring styles and configurable output.

Yes. Low install friction, active maintenance, no known vulnerabilities, and a permissive license make it a straightforward choice. Install it if you need to generate Markdown API docs from Python packages; the command-line interface is simple and the configuration is minimal.

## Install

pip install griffe2md
uv add griffe2md
poetry add griffe2md

## Installing griffe2md

Before you install: Low friction install with a pure Python wheel. Actively maintained with recent releases; last commit 2026-03-12 and marked as active status.

License in practice: ISC license is permissive, allowing commercial and private use with minimal restrictions.

Quickstart:

pip install griffe2md
griffe2md package_name -o docs.md

Requires Python 3.10 or later.

Verify before relying:

- Whether Griffe's static analysis covers all Python docstring formats beyond the documented sphinx style
- Performance characteristics when processing large or deeply nested packages

## Package facts

- License: ISC (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 276.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

generate markdown api docs, python api documentation generator, griffe markdown output, convert docstrings to markdown, api doc markdown export, api-documentation, markdown-generation, static-analysis

[View on SkillFed](https://skillfed.io/packages/griffe2md) · [View on PyPI](https://pypi.org/project/griffe2md/)