You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

如何在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单元格里用图片语法就能插入图:

  • 本地图片:![图片说明](本地图片路径),比如![乘客年龄分布](./images/age-dist.png),把图片放在Notebook同级的images文件夹里即可
  • 在线图片:![图片说明](图片网址),不过如果要离线运行Notebook,建议用本地图片更稳妥

5. 交替排布代码和Markdown单元格

想要像示例Kernel那样在代码间穿插内容,只要交替添加Markdown单元格和代码单元格就行:

  1. 先写一段Markdown单元格,说明接下来要做什么(比如「以下代码用于加载并查看数据集基本信息」)
  2. 再添加一个代码单元格,写对应的代码并运行
  3. 接着再用Markdown单元格解释代码运行的结果、补充注意事项,或者插入相关的图表辅助理解

这样一步步下来,你的Notebook就能像那个示例一样,既有可运行的代码,又有清晰的上下文说明啦!

内容的提问来源于stack exchange,提问作者calicationoflife

火山引擎 最新活动