必须先将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。

• 按 Shift + Enter：渲染当前 Cell，并跳到下一个 Cell
• 按 Ctrl + Enter（Windows/Linux）或 Cmd + Enter（macOS）：只渲染当前 Cell，光标停留不动

常见错误：写了 # 标题 却没按 Shift + Enter，结果看到的还是带井号的原文——不是语法错了，是根本没触发解析。

Markdown to PDF Converter (v2.0)

离线Markdown转PDF转换器，基于Pandoc与WeasyPrint，支持完整Unicode及本地表情缓存，可将Markdown转为专业级PDF...

下载

哪些 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*列表项*

• 或者干脆切回 Code Cell（按 Y），再用 print() 输出字符串——虽然多一步，但最保险

真正容易被忽略的是：**渲染后的 Markdown Cell 无法直接编辑源码**——双击进去看到的是渲染后效果，得按 Enter 进入编辑模式才能改原文。这点和 Code Cell 完全相反。