必须先将单元格类型切换为Markdown：选中单元格（命令模式，左侧蓝边），按M键或右键选择“将单元转换为Markdown”，此时左上角显示Markdown标签、边框变绿，双击即可编辑并渲染Markdown语法。

怎么把普通单元格变成 Markdown 单元格

默认新建的单元格是 Code 类型，直接写 Markdown 语法不会渲染——它会当成 Python 代码报错或静默忽略。必须先切换类型。

操作很简单：选中单元格（命令模式下左侧蓝边），按 M 键；或者右键 →「将单元转换为 Markdown」。此时单元格左上角会显示 Markdown 标签，边框变绿，双击即可编辑。

• 快捷键 M 只在命令模式有效（按 Esc 确保已退出编辑）
• 如果误按了 Y，单元格会变回 Code，内容保留但不渲染 Markdown
• 已写好 Markdown 内容的 Code 单元格，切类型后无需重写，直接生效

%%markdown 魔术命令能用吗

能用，但不推荐日常使用。它只在 Code 单元格里起作用，强制把当前单元格当作 Markdown 渲染，属于“绕过类型切换”的临时方案。

示例：

%%markdown<br># 标题<br>- 列表项<br>`inline code`

Xlsx To Markdown

文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。

下载

• 运行后会正常渲染，但单元格仍标记为 Code，容易混淆后续维护
• 不支持所有 Markdown 扩展（如某些 nbextension 插件功能可能失效）
• 仅适合调试或批量插入纯文本场景，比如从外部读取 .md 文件内容后动态执行

Markdown 单元格里哪些语法容易出错

Jupyter 的 Markdown 渲染基于 MathJax 和 HTML 子集，不是全兼容标准 CommonMark，几个高频坑点：

• $$...$$ 公式块必须独占一行，$...$ 行内公式不能跨行，否则不解析
• 表格前必须空一行，且对齐符号 : 位置影响左/右/居中（:-- 左对齐，--: 右对齐，:-: 居中）
• <img> 标签路径用相对路径时，基准是 notebook 所在目录，不是当前脚本路径
• 换行需两个空格+回车，或用 <br>；单回车会被忽略

保存后 Markdown 内容为什么显示为源码

常见于导出或分享场景：notebook 文件（.ipynb）本身存的是原始 Markdown 字符串，渲染依赖 Jupyter 前端。如果用其他工具打开（如 VS Code 默认插件、GitHub 原始查看），只会看到源码。

• 确认是否在 Jupyter 或 JupyterLab 中打开——这是唯一保证实时渲染的环境
• 导出为 HTML（File → Download as → HTML）可固化渲染效果
• GitHub 上想预览，需用 jupyter nbconvert --to html 生成静态页再上传

真正卡住人的往往不是语法，而是单元格类型没切对、路径相对基准搞错、或误以为 GitHub 能直渲 notebook 里的 Markdown。这些点盯住就稳了。