必须先将Cell类型切换为Markdown：命令模式下按M，或通过菜单/右键操作；切换后需按Shift+Enter或Ctrl+Enter运行才能渲染Markdown内容，否则仅显示源码。
如何把普通 Cell 变成 Markdown Cell
默认新建的 Cell 是 Code 类型，直接输 Markdown 语法不会渲染——它会被当成 Python 代码报错或原样显示。必须先切换类型。
操作方式有三种，推荐用快捷键：
- 选中 Cell 后按
M（命令模式下），立刻转为Markdown类型 - 菜单栏点击 Cell → Cell Type → Markdown
- 右键 Cell → Cell Type → Markdown
注意：必须在「命令模式」（Esc 退出编辑后）按 M 才生效；如果光标在编辑中按 M，会插入字母 m 而不是切换类型。
输入后怎么让 Markdown 生效
写完 Markdown 内容后，必须执行一次渲染，否则只是纯文本。这不是“保存”，而是“运行”这个 Cell。
Markdown to PDF Converter (v2.0)
下载
离线Markdown转PDF转换器，基于Pandoc与WeasyPrint，支持完整Unicode及本地表情缓存，可将Markdown转为专业级PDF...
- 按
Shift + Enter：渲染当前 Cell，并跳到下一个 Cell - 按
Ctrl + Enter（Windows/Linux）或Cmd + Enter（macOS）：只渲染当前 Cell，光标停留不动
常见错误：写了 # 标题 却没按 Shift + Enter，结果看到的还是带井号的原文——不是语法错了，是根本没触发解析。
哪些 Markdown 语法在 Jupyter 中不 work
Jupyter 的 Markdown 渲染器基于 nbconvert + MathJax，不是全兼容 GitHub Flavored Markdown。容易翻车的点：
-
~~删除线~~支持，但==高亮==不支持（得用 HTML：<mark>高亮</mark>） - 表格必须前后空行，否则不渲染；列对齐符号
:必须紧贴分隔线，如| :-- | --: | :-: | - 图片路径如果是相对路径，以 notebook 当前目录为根，不是项目根目录；
./img/a.png和img/a.png效果可能不同 -
$$\nE=mc^2\n$$支持块级公式，但$E=mc^2$行内公式需确保前后无空格，否则可能被当作文本
想临时禁用 Markdown 解析怎么办
比如你要展示一段 Markdown 源码本身（例如教别人怎么写标题），又不想让它被渲染：
- 用反斜杠转义关键符号：
\# 这不会变成标题、\*这不是斜体\* - 包裹在
```里变成代码块：# 这段会被原样显示\n*列表项*
- 或者干脆切回
CodeCell（按Y），再用print()输出字符串——虽然多一步，但最保险
真正容易被忽略的是：**渲染后的 Markdown Cell 无法直接编辑源码**——双击进去看到的是渲染后效果，得按 Enter 进入编辑模式才能改原文。这点和 Code Cell 完全相反。
