linear 不支持 html 渲染，仅限基础 markdown（加粗、斜体、代码块、链接、换行需空行），不支持表格、图片、折叠块、iframe 等；复杂内容需转图上传，模板可用 vs code 预览或 ci 注入 markdown。
linear 中根本不能直接渲染 html
linear 不解析 <div>、<code><strong></strong> 或任何 html 标签，所有 html 字符串都会被原样显示为纯文本。这不是配置问题，是产品设计限制 —— 它只支持有限的 markdown（比如 **bold**、`inline code`、列表和链接），连 <br> 都会被当作文本输出。
用 Markdown 模拟简单 HTML 效果
虽然不能写 HTML，但 Linear 的 Markdown 渲染器支持部分基础格式，可覆盖常见说明需求：
-
**加粗**替代<strong></strong>，*斜体*替代<i></i> -
`code`渲染为等宽字体，适合参数名、函数名（如useState、fetch()） - 用
```js包裹代码块，支持语法高亮（但仅限 js/ts/json/shell 等有限语言） - 链接必须用
[文字](url)，<a href="..."></a>无效 - 换行需空一行，单个
\n不生效；想强制换行？只能靠列表项或段落分隔
复杂排版（表格/图标/折叠块）没得救
Linear 原生不支持：
- Markdown 表格渲染异常（列对不齐、边框丢失）
- SVG 或
<img>标签完全不解析，仅在附件上传后才显示预览图 - 没有 Details/Summary 折叠语法（
<details><summary></summary></details>）、无自定义 class 或 style - 无法嵌入 iframe、script、style —— 所有标签字符均被转义输出
如果真需要展示结构化数据，唯一办法是导出为图片（如用 Mermaid Live Editor 生成流程图截图）再上传。
自动化插入 Markdown 的可行路径
如果你在写大量 Issue 模板或 PR 描述，可以借助工具减少手写成本：
- 用 VS Code 插件（如 “Markdown Preview Enhanced”）实时预览效果，避免提交后才发现格式错乱
- 在模板中用占位符（如
{{API_URL}}），配合脚本替换为真实值后再粘贴进 Linear - CI 流程中用
gh issue create命令行工具 +--body-file参数注入预处理好的 Markdown 文件 - 注意：不要依赖 HTML-to-Markdown 转换器（如
turndown），它会把<h3>标题</h3>变成### 标题，但 Linear 对某些 Markdown 扩展语法（如任务列表- [ ]）支持不稳定
真正卡住人的地方不是“怎么写”，而是 Linear 的 Markdown 解析器比 GitHub 还保守 —— 连 ~~strikethrough~~ 都不支持。别跟它较劲，能用 `backticks` 和空行解决的，就别想 HTML。
