【V1.0】Typora 中的 HTML 支持｜软件文档自翻译

【文章说明】本文章为博主对 Typora 官方文档的翻译。

• 原文版本：Updated · January 17, 2025
• 译文版本：V1.0 于 2026-02-25 发布

• 内联 HTML 标签，将会在你输入关闭标签后立即渲染。该行为与其他 Markdown 内联语法相同。
• 其他支持的标签渲染在一个分离的块中。该行为与数学块相同。
• 出于安全考虑，不支持脚本，包括<script>与onload属性。
• 在<iframe>中允许脚本，但是它将会包装在sandbox属性中，并且没有对文档中其他内容或本地文件的访问权限。

目录

• [内联 HTML](#内联 HTML)
• [HTML 实体](#HTML 实体)
• [HTML 块](#HTML 块)
• 媒体与嵌入内容
• • 视频
  • 音频
  • 嵌入Web内容
  • ~~PDF~~
• 注释
• [`<Strong>` 还是 `**` ?](#<Strong> 还是 ** ?)
• 限制

内联 HTML

隐藏内容（导出后不可见）：<span style="display:none">I am hidden after export</span>

HTML 实体

• HTML 实体语法：&entity_name; 或 &entity_number; 可用于表示 HTML 保留字或 Unicode 字符
• 如注册商标符号：® 会显示为 ®
• 某些实用的 HTML 字符实体
  •  
    • 如果想让两个单词始终在同一行显示，可使用它代替空格。
    • 如果不想让浏览器折叠空格，可使用它代替空格。

HTML 块

• Markdown 文档中的块级 HTML 标签和"不可见"的标签将被渲染为一个 HTML 块

  • 比如：用<details../>搭配<summary.../>使用，可以模拟记忆卡片：

    <details>
        <summary>I have keys but no locks. I have space but no room. You can enter but can't leave. What am I?</summary>
        A keyboard.
    </details>

• 进入 HTML 模块编辑模式的方法

  • 将指针移入它
  • 单击它的非交互性部分
  • Command/Ctrl + 单击

• 在 HTML 块中，Markdown 语法不会被解析。

• 某些内联标签的编辑行为，比如svg，与块级 HTML 标签相同。

• Typora 对于"不可见"的标签不显示预览，只显示源代码。

媒体与嵌入内容

视频

• 你可以像这样嵌入一个视频：<video src="xxx.mp4" />
• 你也可以将一个视频文件拖放进Typora，Typora 将会自动插入视频。
• Video 的路径规则与图像相同。

音频

• <audio src="xxx.mp3" />

嵌入Web内容

• 某些网站允许你嵌入它们的内容到其他网页，它们中的大多数支持<iframe>，Typora 同样也支持。你可以遵从它们的"分享"页/对话框，并将代码粘贴至 Typora 中。
• 某些网站仅提供一段基于 Javascript 的嵌入代码，Typora 仅支持其中的一些。
• 在未来的更新中，我们将会考虑允许用户配置"白名单"。

PDF

• 不再支持，你可以尝试使用在线文件预览器代替。

注释

• Typora支持 HTML 注释。

<Strong> 还是 ** ?

• 如果条件允许，请尽量使用 Markdown 语法。

限制

• 在一个 HTML 块中不允许有空行，否则将渲染为两个 HTML 块。
• 在 Typora 中，只有使用保留字的 HTML 标签会被渲染为 HTML 内容。自定义标签将被忽略。
• 并不是所有的属性都被支持。HTML 中的id, class, data-* 与未知属性在渲染时不会被包含。
• 脚本基本不被允许。<style> 与 <meta>也不会生效。
• 不是所有的 HTML 标签/样式可以被导出为其他格式。导出为 PDF、HTML 或与 HTML 兼容的格式 (比如 EPub) 将会保留 HTML 内容；但是导出为其他格式，比如 Word 或 LaTeX, HTML 内容可能会变为纯文本。