HTML转ClickUp方法详解｜支持导入导出

ClickUp 并非真正支持 HTML 导入，其富文本编辑器本质是 Markdown 友好型系统，仅将少数基础 HTML 标签（如 ``、``、`

`）当作格式提示，而主动剥离所有 `style` 属性、内联 CSS、复杂结构（如 `colspan`、`

ClickUp 导入 HTML 时会丢样式和结构，根本原因是什么

ClickUp 的富文本编辑器不解析 HTML 标签，只把

、、

、
• 这类基础标签当格式提示，其余如
  、、style 属性、内联 CSS 全部被剥离或转成纯文本。这不是 bug，是设计如此——它本质是个 Markdown 友好型编辑器，HTML 只是“可容忍的输入”，不是“受支持的格式”。

  常见错误现象：
  • 粘贴含

  ... 的 HTML，结果变成一堆乱码文字
  • 表格保留了行列，但 colspan、border 全失效
  • 图片路径（如 ./img/logo.png）直接显示为文字，不加载

  用 pandoc 把 HTML 转成 ClickUp 实际能吃的 Markdown

  ClickUp 渲染最稳的是它的私有 Markdown 变体（比如支持 /callout、/todo），而标准 HTML 到这种 Markdown 需要精准降级。pandoc 是目前唯一能可控处理嵌套结构、表格语义、列表缩进的工具。

  实操建议：
  • 安装 pandoc 后运行：

  pandoc input.html -f html -t gfm --wrap=none -o output.md

  
  • 关键参数说明：
   – -f html：明确输入是 HTML（别省略，否则自动探测常误判）
   – -t gfm：输出 GitHub Flavored Markdown，ClickUp 兼容度最高
   – --wrap=none：避免 pandoc 自动折行长段落，防止 ClickUp 解析错行
  • 不要用 -t markdown，它输出的语法（如老式列表缩进）ClickUp 渲染经常错位

  图片路径必须转成绝对 URL 或 base64，本地相对路径无效

  ClickUp 不读取你本地文件系统，所有 类路径都会失效。它只接受两种形式：

  • 绝对 HTTP(S) URL（推荐）：
   → 把 ./assets/chart.svg 改成 https://your-cdn.com/assets/chart.svg
  • Base64 内联（适合小图）：
   → 用命令行转：

  base64 -i chart.svg | tr -d '\n' | sed 's/^/data:image\/svg\+xml;base64,/'

  
   → 替换到 Markdown 中：![chart](data:image/svg+xml;base64,PHN2Zy4uLg==)

  容易踩的坑：
  • 用 file:/// 协议？ClickUp 直接忽略
  • 图片名含空格或中文？URL 编码没做全会导致加载失败
  • SVG 里有