用途：把 Markdown 转换为 Atlassian Document Format（ADF），用于生成 Jira 议题正文 JSON、Confluence 正文 JSON、Jira ADF JSON 等。涉及 Jira 或 Atlassian API 时，通常应先用 mdadf 生成载荷，而非手工构造 ADF JSON。
主要能力与用法：先用 mdadf --version 检查是否可用，可用则跳过安装。默认使用 --compact 输出紧凑 JSON，除非明确需要美化格式。短片段可通过标准输入传入 Markdown，较大输入或可复用流程传入文件路径。结果过大时用 -o 保存到文件并报告路径，避免刷屏。转换后可简单验证输出是否形如 ADF，例如包含 "type":"doc"。
限制与注意：仅在环境允许时实际运行命令，未验证不得声称安装或转换成功；不要擅自切换平台或 shell。mdadf 失败时在 stderr 输出以 Error: 开头的信息并返回非零退出码，视为硬失败。安装后若找不到命令，可在当前会话使用完整安装路径；多行 Markdown 引号处理麻烦时，写入临时文件再转换；需要提权安装而用户未要求时，改用用户本地安装目录。