Python Jupyter Notebook：如何无需复制粘贴将变量以文本形式显示在单元格

核心思路 #

将变量的结构化/代码化字符串表示，以静态文本形式嵌入Notebook的Markdown单元格中，完全脱离运行会话也能查看变量形态，适合文档留存和代码审阅。

具体实现方式 #

• 手动快速生成
  在代码单元格里运行print(repr(your_variable))（通用变量）或print(json.dumps(your_variable, indent=2))（字典/列表等结构化数据），把输出结果复制到Markdown单元格的代码块中：

  # 示例变量输出
  {'user_id': 101, 'tags': ['python', 'notebook'], 'is_active': True}
  

• 自动生成可复用的静态文本
  写个小函数直接在Notebook里生成带格式的Markdown内容，既可以即时渲染也能复制留存：

  from IPython.display import display, Markdown
  
  def var_to_static(var, var_name):
      md_content = f"### 变量 `{var_name}` 的静态形态\n```python\n{repr(var)}\n```"
      display(Markdown(md_content))
      # 打印纯文本方便复制到独立Markdown单元格
      print(md_content)
  
  # 使用示例
  demo_var = {"items": ["pen", "notebook"], "count": 2}
  var_to_static(demo_var, "demo_var")
  

• 复杂对象自定义输出
  针对类实例这类复杂对象，自定义__repr__方法让输出更清晰：

  class Product:
      def __init__(self, name, price):
          self.name = name
          self.price = price
  
      def __repr__(self):
          return f"Product(name='{self.name}', price={self.price})"
  
  phone = Product("smartphone", 3999)
  print(repr(phone))  # 输出: Product(name='smartphone', price=3999)
  

  把这个结果复制到Markdown代码块即可。

注意事项 #

• 优先用repr()而非str()，前者输出更贴近变量的代码形态，可读性更强；
• 大体积变量建议只截取关键部分，避免Markdown单元格过于冗长。

内容的提问来源于stack exchange，提问作者Rub