pydoc-markdown


Namepydoc-markdown JSON
Version 4.8.2 PyPI version JSON
download
home_page
SummaryCreate Python API documentation in Markdown format.
upload_time2023-06-26 12:37:01
maintainer
docs_urlNone
authorNiklas Rosenstein
requires_python>=3.7,<4.0
licenseMIT
keywords documentation docs generator markdown pydoc
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # Pydoc-Markdown 📃

![Python versions](https://img.shields.io/pypi/pyversions/pydoc-markdown?style=for-the-badge)
[![Pypi version](https://img.shields.io/pypi/v/pydoc-markdown?style=for-the-badge)](https://pypi.org/project/pydoc-markdown/)

Pydoc-Markdown is a tool to create Python API documentation in Markdown format. Instead of executing your Python
code like so many other documentation tools, it parses it using [docspec][] instead.

[→ Go to the Documentation 📘][Documentation]

  [contrib]: https://github.com/NiklasRosenstein/pydoc-markdown/blob/develop/.github/CONTRIBUTING.md
  [docspec]: https://niklasrosenstein.github.io/docspec/
  [Documentation]: https://niklasrosenstein.github.io/pydoc-markdown/
  [MkDocs]: https://www.mkdocs.org/
  [Novella]: https://niklasrosenstein.github.io/novella/
  [Novella build backend]: https://niklasrosenstein.github.io/pydoc-markdown/usage/novella/

__Table of Contents__

* [Installation 📦](#installation-)
* [Features 🌟](#features-)
* [News 📢](#news-)
  * [4.7.0 (Undeprecating YAML configuration)](#470-undeprecating-yaml-configuration)
  * [4.6.0 (Novella integration)](#460-novella-integration)
* [Contributing to Pydoc-Markdown 🤝](#contributing-to-pydoc-markdown-)
* [Questions / Need help? 🤔](#questions--need-help-)
* [Projects using Pydoc-Markdown 📚](#projects-using-pydoc-markdown-)

### Installation 📦

You can install Pydoc-Markdown using Pipx:

    $ pipx install pydoc-markdown

If you plan on using the [Novella][] integration, you may want to install it as:

    $ pipx install novella
    $ pipx inject novella pydoc-markdown[novella]

You need at least Python 3.7 to run Pydoc-Markdown. The Python version compatibility of the package you are looking to
generate documentation for is irrelevant.

### Features 🌟

* Understands multiple documentation styles (Sphinx, Google, Pydoc-Markdown specific) and converts them to properly
  formatted Markdown
* Can parse docstrings for variables thanks to [docspec][] (`#:` block before or string literal after the statement)
* Generates links to other API objects per the documentation syntax (e.g. `#OtherClass` for the Pydoc-Markdown style)
* Configure the output using a YAML file or `pyProject.toml`, then you're only one command away to generate the
  documentation in Markdown format
* Or use [Novella][] to tightly integrate with static site generators like MkDocs and Hugo with with additional
  features such as Markdown pre-processing

### News 📢

#### 4.7.0 (Undeprecating YAML configuration)

Many users prefer the YAML configuration over the using [Novella][], which is why starting with __4.7.0__, the YAML
style configuration is officially un-deprecated and will continue to be supported.

#### 4.6.0 (Novella integration)

Starting with __4.6.0__, development focuses on integrating with [Novella][] and use it as a replacement for
tool-specific renderers thus far provided directly by Pydoc-Markdown (i.e. integrations with MkDocs, Hugo and
Docusuraus). Such integrations are/will be provided by Novella instead.

With the Novella integration, you can now place generated API content in Markdown format inline with your
existing Markdown documentation source files using `@pydoc` tags. Check out the [Documentation][] for more
information on how to use Pydoc-Markdown with Novella.

The old style of using Pydoc-Markdown with a YAML or PyProject configuration to generate files and kick off the
build is now deprecated but will be maintained for the foreseeable future (at least until the next major version
bump). It is strongly recommended to migrate your existing projects to using the Novella build backend.

### Contributing to Pydoc-Markdown 🤝

All contributions are welcome! Check out the [Contribution Guidelines][contrib].

### Questions / Need help? 🤔

Feel free to open a topic on [GitHub Discussions](https://github.com/NiklasRosenstein/pydoc-markdown/discussions)!

### Projects using Pydoc-Markdown 📚

An incomplete list of projects that use Pydoc-Markdown to generate their API documentation. Feel free to open a
pull request to add your project to this list!

* [CosmPy](https://docs.fetch.ai/CosmPy/)
* [haystack by deepset](https://docs.haystack.deepset.ai/reference/agent-api)
* [tensorchord/envd](https://envd.tensorchord.ai/api/starlark/v0/config.html)
* [tqdm](https://tqdm.github.io/)

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "pydoc-markdown",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7,<4.0",
    "maintainer_email": "",
    "keywords": "documentation,docs,generator,markdown,pydoc",
    "author": "Niklas Rosenstein",
    "author_email": "rosensteinniklas@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/e1/8a/2c7f7ad656d22371a596d232fc140327b958d7f1d491b889632ea0cb7e87/pydoc_markdown-4.8.2.tar.gz",
    "platform": null,
    "description": "# Pydoc-Markdown \ud83d\udcc3\n\n![Python versions](https://img.shields.io/pypi/pyversions/pydoc-markdown?style=for-the-badge)\n[![Pypi version](https://img.shields.io/pypi/v/pydoc-markdown?style=for-the-badge)](https://pypi.org/project/pydoc-markdown/)\n\nPydoc-Markdown is a tool to create Python API documentation in Markdown format. Instead of executing your Python\ncode like so many other documentation tools, it parses it using [docspec][] instead.\n\n[\u2192 Go to the Documentation \ud83d\udcd8][Documentation]\n\n  [contrib]: https://github.com/NiklasRosenstein/pydoc-markdown/blob/develop/.github/CONTRIBUTING.md\n  [docspec]: https://niklasrosenstein.github.io/docspec/\n  [Documentation]: https://niklasrosenstein.github.io/pydoc-markdown/\n  [MkDocs]: https://www.mkdocs.org/\n  [Novella]: https://niklasrosenstein.github.io/novella/\n  [Novella build backend]: https://niklasrosenstein.github.io/pydoc-markdown/usage/novella/\n\n__Table of Contents__\n\n* [Installation \ud83d\udce6](#installation-)\n* [Features \ud83c\udf1f](#features-)\n* [News \ud83d\udce2](#news-)\n  * [4.7.0 (Undeprecating YAML configuration)](#470-undeprecating-yaml-configuration)\n  * [4.6.0 (Novella integration)](#460-novella-integration)\n* [Contributing to Pydoc-Markdown \ud83e\udd1d](#contributing-to-pydoc-markdown-)\n* [Questions / Need help? \ud83e\udd14](#questions--need-help-)\n* [Projects using Pydoc-Markdown \ud83d\udcda](#projects-using-pydoc-markdown-)\n\n### Installation \ud83d\udce6\n\nYou can install Pydoc-Markdown using Pipx:\n\n    $ pipx install pydoc-markdown\n\nIf you plan on using the [Novella][] integration, you may want to install it as:\n\n    $ pipx install novella\n    $ pipx inject novella pydoc-markdown[novella]\n\nYou need at least Python 3.7 to run Pydoc-Markdown. The Python version compatibility of the package you are looking to\ngenerate documentation for is irrelevant.\n\n### Features \ud83c\udf1f\n\n* Understands multiple documentation styles (Sphinx, Google, Pydoc-Markdown specific) and converts them to properly\n  formatted Markdown\n* Can parse docstrings for variables thanks to [docspec][] (`#:` block before or string literal after the statement)\n* Generates links to other API objects per the documentation syntax (e.g. `#OtherClass` for the Pydoc-Markdown style)\n* Configure the output using a YAML file or `pyProject.toml`, then you're only one command away to generate the\n  documentation in Markdown format\n* Or use [Novella][] to tightly integrate with static site generators like MkDocs and Hugo with with additional\n  features such as Markdown pre-processing\n\n### News \ud83d\udce2\n\n#### 4.7.0 (Undeprecating YAML configuration)\n\nMany users prefer the YAML configuration over the using [Novella][], which is why starting with __4.7.0__, the YAML\nstyle configuration is officially un-deprecated and will continue to be supported.\n\n#### 4.6.0 (Novella integration)\n\nStarting with __4.6.0__, development focuses on integrating with [Novella][] and use it as a replacement for\ntool-specific renderers thus far provided directly by Pydoc-Markdown (i.e. integrations with MkDocs, Hugo and\nDocusuraus). Such integrations are/will be provided by Novella instead.\n\nWith the Novella integration, you can now place generated API content in Markdown format inline with your\nexisting Markdown documentation source files using `@pydoc` tags. Check out the [Documentation][] for more\ninformation on how to use Pydoc-Markdown with Novella.\n\nThe old style of using Pydoc-Markdown with a YAML or PyProject configuration to generate files and kick off the\nbuild is now deprecated but will be maintained for the foreseeable future (at least until the next major version\nbump). It is strongly recommended to migrate your existing projects to using the Novella build backend.\n\n### Contributing to Pydoc-Markdown \ud83e\udd1d\n\nAll contributions are welcome! Check out the [Contribution Guidelines][contrib].\n\n### Questions / Need help? \ud83e\udd14\n\nFeel free to open a topic on [GitHub Discussions](https://github.com/NiklasRosenstein/pydoc-markdown/discussions)!\n\n### Projects using Pydoc-Markdown \ud83d\udcda\n\nAn incomplete list of projects that use Pydoc-Markdown to generate their API documentation. Feel free to open a\npull request to add your project to this list!\n\n* [CosmPy](https://docs.fetch.ai/CosmPy/)\n* [haystack by deepset](https://docs.haystack.deepset.ai/reference/agent-api)\n* [tensorchord/envd](https://envd.tensorchord.ai/api/starlark/v0/config.html)\n* [tqdm](https://tqdm.github.io/)\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Create Python API documentation in Markdown format.",
    "version": "4.8.2",
    "project_urls": {
        "Homepage": "https://github.com/NiklasRosenstein/pydoc-markdown"
    },
    "split_keywords": [
        "documentation",
        "docs",
        "generator",
        "markdown",
        "pydoc"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "835ace0b056d9a95fd0c06a6cfa5972477d79353392d19230c748a7ba5a9df04",
                "md5": "cc9cbbf6940dc0c848de24e45787d426",
                "sha256": "203f74119e6bb2f9deba43d452422de7c8ec31955b61e0620fa4dd8c2611715f"
            },
            "downloads": -1,
            "filename": "pydoc_markdown-4.8.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "cc9cbbf6940dc0c848de24e45787d426",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7,<4.0",
            "size": 67830,
            "upload_time": "2023-06-26T12:36:59",
            "upload_time_iso_8601": "2023-06-26T12:36:59.502034Z",
            "url": "https://files.pythonhosted.org/packages/83/5a/ce0b056d9a95fd0c06a6cfa5972477d79353392d19230c748a7ba5a9df04/pydoc_markdown-4.8.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e18a2c7f7ad656d22371a596d232fc140327b958d7f1d491b889632ea0cb7e87",
                "md5": "0003a1808acd1ca702bc3c6fdb275024",
                "sha256": "fb6c927e31386de17472d42f9bd3d3be2905977d026f6216881c65145aa67f0b"
            },
            "downloads": -1,
            "filename": "pydoc_markdown-4.8.2.tar.gz",
            "has_sig": false,
            "md5_digest": "0003a1808acd1ca702bc3c6fdb275024",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7,<4.0",
            "size": 44506,
            "upload_time": "2023-06-26T12:37:01",
            "upload_time_iso_8601": "2023-06-26T12:37:01.152239Z",
            "url": "https://files.pythonhosted.org/packages/e1/8a/2c7f7ad656d22371a596d232fc140327b958d7f1d491b889632ea0cb7e87/pydoc_markdown-4.8.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-06-26 12:37:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "NiklasRosenstein",
    "github_project": "pydoc-markdown",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "pydoc-markdown"
}
Niklas Rosenstein
Elapsed time: 0.09575s