直接用markdown库转换需指定encoding="utf-8-sig"读取文件以去除BOM，并显式启用tables、toc等扩展，否则表格、目录等功能不生效；安装必须用pip install markdown（小写），非Markdown。
直接用 markdown 库就能把 Markdown 文件转成 HTML，但默认不支持表格、脚注、代码高亮等常见扩展——得手动开开关，否则渲染出来会丢内容或报错。
如何正确加载并解析 Markdown 文件
别用 open().read() 后直接丢给 markdown.markdown() 就完事。文件编码、换行符、BOM 头都可能让解析出错，尤其 Windows 下带 BOM 的 UTF-8 文件会多出乱码字符。
- 始终指定
encoding="utf-8-sig"（自动剥离 BOM） - 用
with open(path, encoding="utf-8-sig") as f:安全读取 - 避免用
str.replace("\r\n", "\n")手动处理换行——open()在文本模式下已自动标准化为\n
示例：
import markdown
with open("README.md", encoding="utf-8-sig") as f:
md_text = f.read()
html = markdown.markdown(md_text)
为什么表格/目录/删除线没渲染出来
因为 markdown 库默认只启用基础语法（标题、列表、段落），所有扩展功能都得显式启用。比如表格依赖 tables 扩展，目录需要 toc，删除线靠 strikeout。
立即学习“Python免费学习笔记（深入）”；
- 启用常用扩展：
extensions=["tables", "fenced_code", "codehilite", "toc", "md_in_html"] -
codehilite需配合 Pygments（pip install pygments），否则代码块只是<pre class="brush:php;toolbar:false;"><code></code>，没样式</li> <li><code>toc</code> 生成的目录是纯 HTML，不含 JS 交互；若需滚动锚点联动，得自己加 CSS/JS</li> </ul> <p>完整调用示例：</p> <pre class='brush:python;toolbar:false;'>html = markdown.markdown( md_text, extensions=[ "tables", "fenced_code", "codehilite", "toc", "md_in_html" ], extension_configs={ "codehilite": {"guess_lang": False, "css_class": "highlight"} } ) </pre> <h3>遇到“ModuleNotFoundError: No module named 'markdown'"怎么办</h3> <p>不是标准库，必须单独装。但注意：PyPI 上有两个主力包——<code>markdown（原生 Python 实现，维护活跃）和Markdown（旧版，已归档）。装错会导致导入失败或功能缺失。- 执行
pip install markdown（小写，无下划线） - 验证安装：
python -c "import markdown; print(markdown.__version__)"，输出应为 3.6+ 版本 - 如果之前装过
Markdown（大写），先pip uninstall Markdown再重装
扩展配置项名和实际行为常有出入，比如
toc的permalink参数要设成True才生成锚点图标，但文档里藏得深；codehilite的pygments_style若填错值（如"github-dark"但未安装对应 style），会静默退回到默认样式——这类细节不跑一遍根本发现不了。 - 执行
