如何在Jupyter Notebook中通过弹出链接下载HTML文件并保留双引号、单引号等特殊字符

你遇到的问题很典型——在Jupyter里生成HTML下载链接时，内容里的双引号（"）、单引号（'）直接拼进代码后，会破坏下载链接的HTML结构，导致链接截断失效，而且还得完整保留这些字符不能替换。

问题根源 #

你原来的代码直接把未编码的HTML内容塞进了<a>标签的href属性里，当内容里出现和href属性相同的引号时，浏览器会误以为属性值已经结束，后面的代码就乱掉了，这就是你看到结果截断的原因。

解决方案：URL编码保留原始字符 #

核心思路是对HTML内容做URL编码，把所有特殊字符转成浏览器能正确识别的编码形式，既保留原内容的所有字符，又不会破坏链接结构。

修改后的完整Python代码：

from IPython.display import HTML
import urllib.parse

title = "Download HTML file"
filename = "data.html"

# 安全读取HTML文件内容
with open("./cobaan_html2.html", "r", encoding="utf-8") as f:
    payload = f.read()

# 对HTML内容做URL编码，保留所有原始字符
encoded_payload = urllib.parse.quote(payload)

# 拼接正确的下载链接HTML模板
html = f'<a download="{filename}" href="data:text/html;charset=utf-8,{encoded_payload}" target="_blank">{title}</a>'

# 在Notebook中渲染下载链接
HTML(html)

代码说明 #

• urllib.parse.quote()会把特殊字符转义：比如"变成%22，'变成%27，<变成%3C，这些编码后的字符不会干扰<a>标签的属性结构。
• 用with open读取文件更安全，同时指定encoding="utf-8"避免编码乱码问题。
• 使用f-string拼接HTML模板，比原始的字符串拼接更清晰，减少出错概率。

效果验证 #

执行这段代码后，生成的下载链接点击就能正常下载HTML文件，文件里的所有引号（包括嵌套的双引号、单引号）都会完整保留，和你原始的HTML内容完全一致，不会再出现截断或结构异常的情况。

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