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

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

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

目录

内联 HTML

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

HTML 实体

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

HTML 块

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

    • 比如:用<details../>搭配<summary.../>使用,可以模拟记忆卡片:
html 复制代码
    <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 内容可能会变为纯文本。
相关推荐
lcy_247 小时前
防抖节流、并发控制、指数退避重试——我把它收进了一个库 async-concurrency-kit
前端
程序员大阳7 小时前
副队长Vue3教程(5)--事件绑定 v-on
前端·javascript·vue.js·vue3·事件绑定·v-on
艾莉丝努力练剑7 小时前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
泯泷8 小时前
Vercel AI SDK 6 完整教程系列 - 第二部分:结构化数据与工具调用
前端·javascript
OpenTiny社区9 小时前
我用Vue 100%复制DeepSeek开源的网页App,代码更少,功能还更多!
前端·vue.js·github
MyBili9 小时前
Chrome开发者工具入门:从看懂页面到高效调试
前端·chrome·谷歌浏览器·开发工具·chrome devtools·网页调式·网络请求分析
云起SAAS10 小时前
手机靓号选号商城H5源码 完整前后台可直接运行
前端·javascript·后端
code2cat10 小时前
JavaScript编程篇之异步请求:切换到待办,为什么又显示了全部任务
前端·javascript
Moment10 小时前
RSI 是怎样让 AI 改进自己的 ❓❓❓
前端·后端·面试
1-1=010 小时前
Vue 条件渲染和列表渲染
前端·javascript·vue.js