{"id":17882734,"url":"https://github.com/joaomcteixeira/hypersimpledocstring2md","last_synced_at":"2026-05-02T05:03:12.826Z","repository":{"id":109147311,"uuid":"163891559","full_name":"joaomcteixeira/HyperSimpleDocstring2Md","owner":"joaomcteixeira","description":"A Hyper Simple Docstring to Markdown. Creates indexed Markdown files from Python libraries docstrings.","archived":false,"fork":false,"pushed_at":"2019-01-12T20:13:54.000Z","size":51,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-03T22:42:20.845Z","etag":null,"topics":["docstring","docstring-documentation","docstring-markdown","documentation","documentation-generator","markdown","pydoc","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joaomcteixeira.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-02T21:29:48.000Z","updated_at":"2020-10-17T16:18:03.000Z","dependencies_parsed_at":"2023-03-07T04:46:01.015Z","dependency_job_id":null,"html_url":"https://github.com/joaomcteixeira/HyperSimpleDocstring2Md","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/joaomcteixeira/HyperSimpleDocstring2Md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomcteixeira%2FHyperSimpleDocstring2Md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomcteixeira%2FHyperSimpleDocstring2Md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomcteixeira%2FHyperSimpleDocstring2Md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomcteixeira%2FHyperSimpleDocstring2Md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joaomcteixeira","download_url":"https://codeload.github.com/joaomcteixeira/HyperSimpleDocstring2Md/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaomcteixeira%2FHyperSimpleDocstring2Md/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32523428,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docstring","docstring-documentation","docstring-markdown","documentation","documentation-generator","markdown","pydoc","python","python3"],"created_at":"2024-10-28T12:57:00.432Z","updated_at":"2026-05-02T05:03:12.809Z","avatar_url":"https://github.com/joaomcteixeira.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HyperSimpleDocstring2Md\n\nA Hyper Simple Docstring to Markdown creator. Creates hierarchically indexed [Markdown](https://en.wikipedia.org/wiki/Markdown) files from [Python](https://www.python.org/) libraries' [docstrings](https://www.python.org/dev/peps/pep-0257/). Fully based on Python standard library.\n\n# Why?\n\nIt is extremely important to maintain software documentation up to date with the latest releases.\n\nThere are many packages out there to efficiently handle the documentation of Python projects, those can extract updated docstrings and setup beautiful web pages accordingly. But, such complex tools require a considerable amount of time and effort to master, and developers should thrive to keep up to date with the most novel routines and styles of documentation representation.\n\nMoreover, in my opinion, these projects fail to address a specific collective of developers: those who thrive, above all, for extreme simplicity, long-term stability and universality of their output, in this case software documentation.\n\n# Solution\n\n**Hyper Simple Docstring 2 Markdown** creator was designed to recursively extract DOCSTRINGS from a target Python package and write them to a simple yet organized and indexed Markdown formatted file. It intents to be exactly that, **hyper simple** in both input and output.\n\nThe output Mardown file can be directly used as a GitHub wiki page, for example.\n\n## Implementation\n\nIt uses Python +3.7 standard libraries, such as [pydoc](https://docs.python.org/3.7/library/pydoc.html) and the [inspect module](https://docs.python.org/3/library/inspect.html).\n\n## Which docstrings are covered?\n\nIn the current version, DOCSTRINGS from packages (`__init__.py`), modules, classes and functions are extracted.\n\n# How to use it\n\nNo installation is required and you only need to pass **one** argument, **it's HYPER SIMPLE**:\n- the PATH to your Python package\n\n```\npython hypersimpledocstring2md.py \u003cPATH TO YOUR LIBRARY\u003e\n```\n\nThis will recursively read your library and generate a `docs.md` file containing all referred docstrings in an organized manner. All subpackages MUST have an `__init__.py` file.\n\n## but there are also additional features\n\nFor example:\n\n- you can add a base web url in order to link the index with the Markdown headers, it will result in `\u003clink\u003e#\u003cheader\u003e`, very useful for GitHub pages.\n\n```\n$ python hypersimpledocstring2md.py -h\nusage: hypersimpledocstring2md.py [-h] [--baselink baselink] [--output OUTPUT]\n                                  path\n\nHyper Simple Docstring 2 Markdown - A routine to create a single Markdown\nformatted file containing the documentation DOCSTRINGS of a target Python\nlibrary.\n\npositional arguments:\n  path                 PATH to Library.\n\noptional arguments:\n  -h, --help           show this help message and exit\n  --baselink baselink  The base Web URL where the .md will be hosted toallow\n                       Index-Header linking. Defaults to no link.\n  --toplink toplink    Adds a quick link to the Index bellow each header.\n                       Defaults to True.\n  --output OUTPUT      The OUTPUT Markdown file. Defaults to 'docs.md'.\n```\n\n## examples\n\nHyperSimpleDocstring2Md is used to generate the Tauren-MD's documentation, [take a look](https://github.com/joaomcteixeira/Tauren-MD/wiki/Modules-Documentation). \n\n# LICENSE\n\nThis software is licensed under the [Unlicense](https://github.com/joaomcteixeira/HyperSimpleDocstring2Md/blob/master/LICENSE) as a demonstration of my gratitute to the whole Python community that cheerily and altruistically share knowledge on the Web. Thanks to the community.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaomcteixeira%2Fhypersimpledocstring2md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoaomcteixeira%2Fhypersimpledocstring2md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaomcteixeira%2Fhypersimpledocstring2md/lists"}