本文提供了一份分步指南,介绍如何使用 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 文章的策略,已通过增量式分步方法得到验证。