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

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.4.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.4-py3-none-any.whl (32.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: griffe2md-1.3.4.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.4.tar.gz
Algorithm Hash digest
SHA256 31dd6e046ca4cd7916985cea23c31e00a65bb114a1548eb5278a3d8ff6dfe6ff
MD5 5265fc7023627db276c572182b6aa540
BLAKE2b-256 f3b46493f09613e2fe452d9dbd3500f244dd794c041b213c256072a2f216964d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: griffe2md-1.3.4-py3-none-any.whl
  • Upload date:
  • Size: 32.0 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 fb13332804a54deeda92714078cede1b1c2a4cd927fe35d8e4724b049e02ac09
MD5 f0d74c95a49f0042e244633bdd7b4440
BLAKE2b-256 f2a8b6352931d276bda71d7f095d4c48690086976493d70f03313d02eb33b5be

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