本文提供了一份分步指南,介绍如何使用 publishing-kit(一个适用于 Claude Code、Codex 和 Antigravity 的智能体技能)将 markdown 文章发布为 LinkedIn 文章。LinkedIn 文章编辑器加入了 dev.to、Medium、Substack 和 AWS Builder Center 的行列,成为一个发布目的地,下面的每一项输出都来自通过它把该工具包自带的演练发布到 LinkedIn 的过程。

https://github.com/xbill9/publishing-kit

输入一个 markdown 文件。输出一篇 LinkedIn 文章,在 LinkedIn 保存后,每个代码块、链接、标题和字符都会与源文件进行核对。


问题是什么?

LinkedIn 文章是位于linkedin.com/article/new/的长文内容,发布在/pulse/之下。它与宣布文章的短动态帖子是分开的。它通过网页编辑器录入,而编辑器决定了哪些内容能保留下来。

将 HTML 粘贴进去,然后重新加载页面,让编辑器显示 LinkedIn 存储的内容,得到如下结果:

内容 在已保存的文章中
多行代码块 🟢 保留,行数相同
figure 中的图片,使用公开 URL 🟢 由 LinkedIn 抓取并重新托管
普通链接、粗体、列表、引用 🟢 保留
图片替代文本 ⚠️ 到达时为空;通过编辑器设置后保留
标题 ⚠️ 保存两个级别;其他级别变成段落
行内代码 ❌ 在编辑器中显示,重新加载后消失
文本为行内代码的链接 ❌ 链接被丢弃
块引用中的第二个段落 ❌ 被丢弃,文本也一并丢失
列表项内的列表 ❌ 合并到其父项中
表格 ❌ 编辑器中不存在表格元素
段落中单独一张图片 ❌ 被丢弃

编辑器对上述任何情况都不报错。文章保存成功,而缺失的部分从页面上消失了。


为什么要在标签页到达 LinkedIn 之前调整 HTML?

该工具包使用浏览器自带的 DOM 解析器来调整文章的 HTML,而该解析器在编辑器页面上不可用。LinkedIn 在那里设置了 Trusted Types 策略,并且DOMParser返回一个没有元素的文档:一个包含 269 个标签的源返回成一整段文本。

所以工作提前一步进行。智能体在127.0.0.1上打开 HTML,在那里进行调整,并将结果存储到window.name中,该存储在同一个标签页导航到 LinkedIn 后仍然保留。编辑器自身的粘贴处理能正确解析该 HTML 字符串。


为什么要保留 LinkedIn 会丢弃的行内代码?

编辑器的 schema 有一个code标记,粘贴的<code>会显示为代码。重新加载后,同样的文本变成纯文本:之前有 40 个代码标记,之后为 0,而旁边的 19 个加粗标记完好无损。

在粘贴前移除行内代码看起来更整洁,但代价不小。编辑器会把任何类似主机名的裸文本变成链接,所以make-medium.py会变成指向http://make-medium.py的链接。如果先移除所有行内代码片段,整个演练过程会为其 4 个真实目标多出 41 个链接标记。保留这些片段后,编辑器不会额外添加链接,重新加载后仍是纯文本和 4 个目标中的 4 个。

一个例外:code标记会排除所有其他标记,因此文本为行内代码的链接会保留代码而丢失链接。只有这些片段会被解包。


与 Medium 和 Substack 相比如何?

三者都不支持表格,因此工具包向 LinkedIn 提供的 HTML 与它为 Medium 构建的相同,而在 Medium 中每个表格已经是图片。差异如下:

  • 标题:Medium 有两种字号,Substack 有六种。LinkedIn 保存两种,Heading为 24px,Subheading为 20px,粘贴时所有标题都会落到较小的那个。
  • 行内代码:Substack 会将其保存为代码。LinkedIn 会丢弃格式但保留文本。
  • 封面:在 Medium 上,第一张正文图片会成为封面。LinkedIn 有单独的封面位置,会裁剪为 16:9。
  • 读回内容:Medium 和 Substack 以 JSON 形式提供已保存的草稿。在 LinkedIn 上,重新加载编辑器会加载已存储的内容。

此时你应该已经具备……

  • 在 Claude Code、Codex 或 Antigravity 中安装 publishing-kit 0.37.1 或更高版本,并具备能在页面中运行 JavaScript 和上传文件的浏览器自动化能力。
  • 一个已登录的 LinkedIn 账号,位于智能体驱动的浏览器中。
  • 一篇已为 Medium 构建好的文章,带有make-medium.py,其图片已提交并推送。
  • 一张 16:9 封面,即工具包为 AWS Builder Center 生成的同一张 1200x675 图片。

第 1 步 — 构建 HTML

LinkedIn 版本就是 Medium 的托管 HTML,因此构建过程就是 Medium 的构建过程:

python3 make-medium.py devto-publishing-kit.md medium
devto-publishing-kit.md: 1 tables, 0 diagrams
   USE THIS   -> medium/devto-publishing-kit-hosted.html  (paste or import; needs medium/img committed AND pushed)
   not this   -> medium/devto-publishing-kit-embed.html   (133 KB; data: URIs, Medium drops them all on paste)

表格会变成 PNG,位于medium/img/下,而-hosted.html通过其公开的 GitHub URL 指向它。LinkedIn 在粘贴时会抓取该 URL,因此图片要先推送。


第 2 步 — 在 127.0.0.1 上调整

智能体在本地提供仓库服务,在那里打开托管 HTML,并求值工具包的辅助函数,scripts/browser/linkedin-article.js:

await lia。stash()
{"html": 11358, "carried": 12023, "first": "TL;DR:publishing-kit
packages 打包了整个发布生命周期",
 "coverDropped": "https://raw.githubusercontent.com/xbill9/publishing-kit/main/articles/publishing-kit-skill/medium/img/cover.ae4d639e.jpg",
 "imagesFigured": 1, "inlineCode": 41, "codeLinksUnwrapped": 2, "quotesSplit": 0, "nestedItemsHoisted": 0,
 "images": 1, "codeBlockLines": [2, 2, 5], "headings": {"h2": 7, "h3": 0},
 "listItems": 10, "blockquotes": 3, "tables": 0, "inkChars": 7853}

stash()完成编辑者需要的每一处改动,并记录它发送了什么:

  • 开头的封面图被移除,因为 LinkedIn 有自己的封面位置。
  • 内联代码两侧的两个链接被解开。其余 41 个内联代码片段保持不变。
  • 源文件中最大的标题变成Heading,任何更小的标题变成Subheading。
  • 包含多个段落的块引用被拆分为每段一个引用,嵌套列表项上移到其父项之后,因此不会丢失任何文本。
  • 单独位于一个段落中的图片被包裹在 figure 中。

inkChars是非空格字符的计数。它是最终检查所比较的数字。


第 3 步 — 粘贴

同一个标签页打开https://www.linkedin.com/article/new/,辅助程序再次被求值,一次合成粘贴将文章放入:

await lia。paste()
{"chars": 9462, "id": "7529254866788106240", "pasted": true, "status": "Draft - saved", "uploadsPending": 0,
 "images": [{"alt": "Table: measured", "rehosted": false, "urn": "urn:li:digitalmediaAsset:D5612AQG98xGoS3wdNw"}]}

第一个输入创建草稿,地址变为/article/edit/<id>/。paste()等待每张图片获得 LinkedIn 资源 ID,设置标题级别,并将替代文本写回每张图片。如果编辑器中已有文本,它会拒绝执行,因此第二次运行不会将文章追加两次。


第 4 步 — 设置标题和封面

标题是一个独立字段,限制为 150 个字符,lia.setTitle()填充它。

封面放在标题上方的位置。lia.coverInput()打开上传对话框并暴露其文件输入,智能体将图片上传到其中。该位置从中心裁剪为 16:9:1376x578 的 dev.to 封面预览为 1027x578,而 1200x675 的 Builder Center 封面则完整预览。上传 16:9 的那张。


第 5 步 — 重新加载,然后检查

粘贴后,编辑器仍显示内联代码和任何标题级别。重新加载后,它保留 LinkedIn 存储的内容,因此此时运行检查:

lia。audit()
problems           []
title              Streamline Publishing with a Claude Code Skill
cover              true
status             Draft - saved
code blocks        3, lines 2/2/5
headings           7, all Heading
link targets       4 of 4
image              re-hosted on media.licdn.com, alt "Table: measured"
non-space chars    7853

audit()将存储的文章与什么进行比较stash()发送:缺失的链接目标和添加的链接目标、代码块行数、图片及其 alt 文本、标题数量、列表项、引用,以及非空格字符的数量。任何差异都会成为problems中的一行。


第 6 步 — 发布

Next在编辑器中会打开一个发帖框,询问文章是关于什么的,其上方是受众,下方是一个Publish按钮。帖子文本是可选的:Publish在框为空时启用。

作者决定发布。对于这篇文章,受众选择了Post to Anyone,框留空,一次点击就发布了。lia.publish()会携带该点击,并且除非屏幕上的受众和帖子文本与给定的一致,否则会拒绝。

标签页切换到已发布页面:

https://www.linkedin.com/pulse/streamline-publishing-claude-code-skill-william-mclean-kay8c/

slug 是 LinkedIn 自己的。它从标题中去掉 "with" 和 "a",并加上作者的名字和五个字符,因此 URL 是从页面上读取的。已发布页面包含与草稿相同的 3 个代码块、3 个引用、10 个列表项和 4 个链接目标,并且 LinkedIn 在同一时刻为文章创建了一条信息流帖子。


第 7 步 — 记录链接

URL 会进入links.txt文章旁边,而工具包的链接检查会与其他链接一起抓取它:

linkedin-article = https://www.linkedin.com/pulse/streamline-publishing-claude-code-skill-william-mclean-kay8c/
python3 check-links.py devto-publishing-kit.md
  ok    links.txt medium: HTTP 200
  ok    links.txt linkedin: HTTP 200
  ok    links.txt repo: HTTP 200
  ok    links.txt substack: HTTP 200
  ok    links.txt linkedin-article: HTTP 200

🔎 提示:来自 /pulse/ 的 200 需要再看一眼

LinkedIn 对不存在的/pulse/地址会以 HTTP 200 响应。它会重定向到/top-content/?trk=article_not_found,一个标题为 "Top Content on LinkedIn" 的页面。工具包的链接检查会让任何落到那里的 URL 失败,因此拼错的文章链接无法凭借其状态码通过。


🔎 提示:确认浏览器加载了当前构建

在重新构建之前打开了 HTML 的标签页127.0.0.1可能会从其缓存中获取较旧的副本。第 5 步中的检查随后会通过,因为它将文章与同一份较旧的副本进行比较。stash()使用以下内容抓取cache: "no-store"并返回first和inkChars。对于这次演练,随着添加 LinkedIn 文章的那次编辑,计数从 7527 变为 7853,读取该数字可以确认标签页中是哪个构建。


🔎 提示:将文件名放在反引号中

写在普通句子中的文件名会在 LinkedIn 编辑器中变成链接:make-medium.py和dev.to在粘贴到代码格式之外时都如此。在反引号内,名称保持为文本。audit()列出源中不包含的任何链接目标。


吃自己的狗粮:通过自己的工具包发布的演练

上面每一步所用的文章,都是这套工具包的操作演示《Streamline Publishing with a Claude Code Skill》。它此前已经发布在 dev.to、Medium、Substack 和 AWS Builder Center 上。新增 LinkedIn 这个发布目的地,意味着要更新文章以说明这一点、重新构建,并让结果走一遍新流程。

这套工具包的三项检查就来自那次运行:

  • 字符数。一个块引用丢掉第二段后,所有元素计数都保持不变。统计两侧的非空格字符数,就能在任何位置发现丢失的文本。
  • 新增的链接。编辑器既会添加链接目标,也会丢弃链接目标,因此audit()会同时报告源中不存在的每个目标和缺失的每个目标。
  • 未找到页面。已发布的 URL 和一个编造的 URL 都返回 200,链接检查通过请求最终落到哪里来区分它们。

操作演示自己的表格为它新增了一行,读数就存放在文章旁边作为证据。


对比与比较

Medium Substack LinkedIn 文章
文章如何进入 浏览器 浏览器 浏览器
表格 图片 图片 图片
多行代码 ❌ 导入时只剩一行 🟢 保留 🟢 保留
行内代码 未测量 🟢 保留 ❌ 仅剩文本
行内代码外的链接 🟢 保留 ❌ 被丢弃;需先解包 ❌ 被丢弃;需先解包
标题层级 2 6 2
封面 正文第一张图 未测量 单独槽位,16:9
HTML 已适配 在生成器中 在编辑器页面中 开启127.0.0.1,在编辑器之前
从以下位置读回 ?format=json /api/v1/drafts/<id> 重新加载后的编辑器

那么,选哪一个?

用同一次构建发布到全部三个平台。LinkedIn 对 Medium HTML 要求的改动最多,保留的格式最少,而辅助工具会在粘贴之前完成这些改动。检查前先重新加载,并从已发布页面读取 URL。


总结

本文的目标是为 publishing-kit 添加 LinkedIn 文章支持,并通过它发布这套工具包自己的操作演示。解决方案的关键是复用 Medium HTML,在127.0.0.1标签到达 LinkedIn 之前对它进行适配,并在重新加载后检查文章。结果如下:

  • 🟢多行代码保留,3 个代码块的行数一致。
  • 🟢全部 4 个链接目标保留,其中行内代码外的两个链接被解包。
  • 🟢表格图片由 LinkedIn 重新托管,alt 文本已恢复。
  • 🟢源文章和保存后的文章中均有 7853 个非空格字符。
  • 🟢一键发布,URL 从页面读取并由该工具包校验。
  • ⚠️两个标题层级被保存,而粘贴时会把每个标题都设为较小的那一级。
  • ⚠️封面槽位裁剪为 16:9。
  • ⚠️一个/pulse/不存在的地址返回 200。
  • ❌没有行内代码,没有表格,没有嵌套列表,并且每个块引用一段。

范围:一篇文章,于 2026-11-19 从可见的浏览器标签页粘贴并发布到一个 LinkedIn 账号,使用 Linux 上 Claude Code 中的 publishing-kit 0.37.1。被丢弃图片那一行来自同一天粘贴的第二篇文章,其中单独位于一个段落中的 9 张图片全部被丢弃,而包裹在 figure 中后 9 张全部到达。编辑已发布文章、定时发布以及后台标签页均未测试。LinkedIn API 能否创建文章未作查证。

将一篇 markdown 文章通过智能体技能发布为 LinkedIn 文章的策略,已通过增量式分步方法得到验证。


参考文献