直接用 composer require league/commonmark 安装即可，它会自动写入 composer.json 并下载最新稳定版；注意 php 版本匹配：^2.4 需 php >=7.4，^3.0 需 php >=8.1；安装后需在入口文件引入 vendor/autoload.php，否则报 class not found。
直接用 composer require 安装就对了
League CommonMark 是 PHP 生态里最主流的 Markdown 解析器，不需要手动下载或配置 autoload —— Composer 原生支持。执行这条命令即可完成安装和自动注册：
composer require league/commonmark
它会自动写入 composer.json 的 require 区块，并下载对应版本（默认最新稳定版）。如果你项目已启用 autoloading（绝大多数现代 PHP 项目都已启用），无需额外操作就能在代码中 use 相关类。
注意 PHP 版本和 CommonMark 版本的匹配关系
不同 league/commonmark 版本对 PHP 有硬性要求，装错会导致 composer install 失败或运行时报 Class not found。常见组合：
-
^2.4要求 PHP >= 7.4（推荐大多数 Laravel 8+/Symfony 5+ 项目） -
^3.0要求 PHP >= 8.1（若你用的是 PHP 8.2/8.3，建议直接上 v3） - 别盲目加
@dev或dev-main，v3 之后的开发分支可能破坏 BC
如需指定版本，显式声明更稳妥：
composer require league/commonmark:^3.0
安装后不生效？检查是否漏了 vendor/autoload.php
CommonMark 不是“开箱即用”的命令行工具，它是一个库，必须通过 Composer 自动加载机制才能被识别。确保你的入口文件（比如 index.php 或测试脚本）开头有这一行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
require __DIR__ . '/vendor/autoload.php';
常见错误现象：
Class 'League\CommonMark\Environment\Environment' not found- 明明
composer show league/commonmark显示已安装，但new Environment()报错 - 只在 CLI 下能跑，Web 环境下报错 —— 很可能是 Web 服务器没读到正确的
autoload.php路径
想快速验证安装是否成功？写个最小可运行示例
新建一个 test.php，内容如下：
<?php require __DIR__ . '/vendor/autoload.php';
<p>use League\CommonMark\Environment\Environment;
use League\CommonMark\Extension\CommonMark\CommonMarkExtension;
use League\CommonMark\Parser\MarkdownParser;
use League\CommonMark\Renderer\HtmlRenderer;<p>$environment = new Environment();
$environment->addExtension(new CommonMarkExtension());
$parser = new MarkdownParser($environment);
$renderer = new HtmlRenderer($environment);</p><p>$html = $renderer->render($parser->parse('# Hello World'));
echo $html;
?></p>
运行 php test.php，输出 <h1>Hello World</h1> 就说明一切正常。注意：v3 中构造方式略有变化（改用 Environment::createCommonMarkEnvironment()），如果用 v3 请查对应文档，别直接套 v2 示例。
真正容易被忽略的是环境一致性 —— CLI 用的 PHP 版本、Web 服务器用的 PHP 版本、以及 composer install 时用的 PHP 版本，三者不一致就会出现「本地能跑，线上报错」这类问题。
