用途：根据 Python 源码生成 Markdown 文档，适用于用户要求“为代码写文档”“生成文档”、创建模块 API 文档、生成带用法示例的 README，或提取 docstring 与类型签名。
输入：单个 Python 文件路径、目录路径（递归处理 .py 文件）或指定文件列表。
输出：标准 Markdown，包含模块名与模块 docstring 简介、Classes（类 docstring、方法签名与简述）、Functions（函数签名、docstring、参数与返回值说明）、Usage Examples（从 docstring 示例提取或生成基础用法）。
分析方式：用 AST 或 inspect 解析 Python 文件；提取模块级 docstring、类定义与 docstring、带类型提示的函数/方法签名、docstring 内容（支持 Google、NumPy、Sphinx 格式）；按模块→类→方法→函数分层组织；生成格式一致的 Markdown。
质量约定：在有意义时保留原 docstring 格式；签名中突出类型提示；将类与函数分别归类；大型模块添加目录；默认跳过以下划线开头的私有成员，除非明确要求；缺失 docstring 时标注“No description provided”。
工具与依赖：优先使用标准库 ast、inspect、pathlib，基础文档生成无需外部依赖。
错误处理：跳过有语法错误的文件并记录警告；优雅处理缺失类型提示；未找到 docstring 时警告但继续处理；处理前校验文件路径存在。
限制：资料未提供安装命令、收费方式、平台支持与具体效果数据。