如何在Jupyter Notebook中添加注释、链接及插图以丰富代码上下文?
嘿,我懂你说的那种在Jupyter Notebook里把代码和丰富的注释、链接、插图无缝结合的需求!其实这全靠Jupyter原生支持的Markdown单元格就能实现,下面给你一步步拆解操作方法:
1. 先学会添加/切换Markdown单元格
在Jupyter Notebook里,单元格默认是代码类型,你可以这么切换成Markdown类型:
- 选中目标单元格后,点击顶部工具栏的下拉菜单(默认显示「Code」),选择「Markdown」
- 或者用快捷键更高效:先按
Esc进入命令模式(单元格边框变蓝色),再按M键,就能快速把代码单元格转成Markdown单元格
2. 编写带格式的注释/上下文文本
在Markdown单元格里,你可以用各种Markdown语法来美化说明内容:
- 标题:用
#开头,比如# 数据处理是一级标题,## 缺失值分析是二级标题,层级清晰 - 强调:用
*斜体*或者**加粗**来突出重点内容,比如注意:这里需要先填充缺失值再建模 - 列表:用
-或者1.来做分点说明,整理思路更清楚 - 引用块:用
>开头,比如> 提示:此步骤参考了Kaggle泰坦尼克号竞赛的经典处理逻辑
3. 插入链接(内部锚点/外部参考)
- 内部锚点链接:如果你想跳转到Notebook里的其他标题(比如示例里的「Data-Handling」章节),可以用
[跳转文本](#标题名称),注意标题要转成小写,空格替换成-,比如[查看数据处理步骤](#data-handling),点击就能直接跳转到对应标题的Markdown单元格 - 外部链接:如果需要引用外部参考资料,可用
[参考文档](文档网址),记得确保网址可访问
4. 插入插图补充说明
在Markdown单元格里用图片语法就能插入图:
- 本地图片:
,比如,把图片放在Notebook同级的images文件夹里即可 - 在线图片:
,不过如果要离线运行Notebook,建议用本地图片更稳妥
5. 交替排布代码和Markdown单元格
想要像示例Kernel那样在代码间穿插内容,只要交替添加Markdown单元格和代码单元格就行:
- 先写一段Markdown单元格,说明接下来要做什么(比如「以下代码用于加载并查看数据集基本信息」)
- 再添加一个代码单元格,写对应的代码并运行
- 接着再用Markdown单元格解释代码运行的结果、补充注意事项,或者插入相关的图表辅助理解
这样一步步下来,你的Notebook就能像那个示例一样,既有可运行的代码,又有清晰的上下文说明啦!
内容的提问来源于stack exchange,提问作者calicationoflife




