Skip to main content

Output API docs to Markdown using Griffe.

Project description

griffe2md

ci documentation pypi version gitter

Output API docs to Markdown using Griffe.

Installation

pip install griffe2md

With uv:

uv tool install griffe2md

Usage

Simply call griffe2md with a package name, or the path to a package folder:

griffe2md markdown
griffe2md path/to/my/src/package

Use the -o, --output option to write to a file instead of standard output:

griffe2md markdown -o markdown.md

griffe2md can be configured in either pyproject.toml or a griffe2md.toml file. The latter can be placed in a .config or config directory in the project root.

griffe2md.toml file is structured as a simple key-value dictionary, e.g.:

docstring_style = "sphinx"

If you configure it in pyproject.toml, the configuration should go under the tool.griffe2md key:

[tool.griffe2md]
docstring_style = "sphinx"

See the documentation for reference.

Sponsors

Silver sponsors

FastAPI
Pydantic

Bronze sponsors

Nixtla


ofek samuelcolvin tlambert03 ssbarnea femtomc cmarqu kolenaIO ramnes machow BenHammersley trevorWieland MarcoGorelli analog-cbarber OdinManiac rstudio-sponsorship schlich butterlyn livingbio NemetschekAllplan EricJayHartman 15r10nk activeloopai roboflow cmclaughlin blaisep RapidataAI rodolphebarbanneau theSymbolSyndicate blakeNaccarato ChargeStorm Alphadelta14 Cusp-AI

And 7 more private sponsor(s).

Project details


Download files

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

Source Distribution

griffe2md-1.3.3.tar.gz (45.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

griffe2md-1.3.3-py3-none-any.whl (32.1 kB view details)

Uploaded Python 3

File details

Details for the file griffe2md-1.3.3.tar.gz.

File metadata

  • Download URL: griffe2md-1.3.3.tar.gz
  • Upload date:
  • Size: 45.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for griffe2md-1.3.3.tar.gz
Algorithm Hash digest
SHA256 28a097c4388ee130bbebfe82b84d8ce176a3ba905c5ef4226cebd53b461b1756
MD5 eb4e9f8595ce869b998a36bb1542541f
BLAKE2b-256 3df4d38ac8ad56995d9ae7f28b1aad57ecfc4c96d14e918f5f8a3bb400e67866

See more details on using hashes here.

File details

Details for the file griffe2md-1.3.3-py3-none-any.whl.

File metadata

  • Download URL: griffe2md-1.3.3-py3-none-any.whl
  • Upload date:
  • Size: 32.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for griffe2md-1.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ed969710e461a0728d04be91a702fccc46ffe13f3281d5c4fe655cd3e93a5c6c
MD5 2720b8cc2e918c22ca2b8c43419c9550
BLAKE2b-256 8a080eedc218f113288095804c719a0a2a391637d8f1de0e7ae3100ab0d7319c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page