Skip to content

topmindspace/topmind-writing-skills / topmind-x-article

topmind-x-article

Verified

创作或整理 X Article 深度长文,支持论点推进、工具/插件介绍、产品实测评测与多源研究;按需导出可复制 HTML、纯文本、封面与发布清单。普通短帖用 topmind-briefs 或 topmind-viral-posts,纯格式化用 topmind-format。

FileKindSize
.gitignoreother31 B
README.en.mdmarkdown1.7 KB
README.mdmarkdown2.0 KB
SKILL.mdskill md4.6 KB
examples/01-长文-慢慢写.mdmarkdown1.8 KB
examples/02-长文-周末短途.mdmarkdown1.4 KB
examples/README.mdmarkdown716 B
knowledge/README.mdmarkdown9.4 KB
knowledge/cards/atlas-local-fix.mdmarkdown781 B
knowledge/cards/brief-news-to-post.mdmarkdown3.0 KB
knowledge/cards/brief-news.mdmarkdown916 B
knowledge/cards/brief-paper.mdmarkdown760 B
knowledge/cards/brief-tools.mdmarkdown617 B
knowledge/cards/brief-value-first.mdmarkdown3.1 KB
knowledge/cards/cover-abstract.mdmarkdown1.3 KB
knowledge/cards/cover-brief.mdmarkdown1.3 KB
knowledge/cards/cover-collage.mdmarkdown1.3 KB
knowledge/cards/cover-color.mdmarkdown1.2 KB
knowledge/cards/cover-culture.mdmarkdown1013 B
knowledge/cards/cover-editorial.mdmarkdown1.2 KB
knowledge/cards/cover-material.mdmarkdown1.3 KB
knowledge/cards/cover-photo.mdmarkdown1.1 KB
knowledge/cards/cover-playful.mdmarkdown1.0 KB
knowledge/cards/cover-scene.mdmarkdown962 B
knowledge/cards/cover-series.mdmarkdown1017 B
knowledge/cards/cover-typography.mdmarkdown1.3 KB
knowledge/cards/creative-choice.mdmarkdown807 B
knowledge/cards/crop-independent.mdmarkdown719 B
knowledge/cards/de-ai-mechanisms.mdmarkdown3.6 KB
knowledge/cards/experience-loop.mdmarkdown801 B
knowledge/cards/format-fidelity.mdmarkdown501 B
knowledge/cards/format-layouts.mdmarkdown502 B
knowledge/cards/poster-paging.mdmarkdown726 B
knowledge/cards/poster-structure.mdmarkdown646 B
knowledge/cards/poster-voices.mdmarkdown530 B
knowledge/cards/reference-reading.mdmarkdown857 B
knowledge/cards/revise-depth.mdmarkdown677 B
knowledge/cards/revise-feedback.mdmarkdown609 B
knowledge/cards/revise-learn-from-edits.mdmarkdown3.1 KB
knowledge/cards/revise-preserve.mdmarkdown788 B
knowledge/cards/viral-mechanisms.mdmarkdown535 B
knowledge/cards/viral-observation.mdmarkdown544 B
knowledge/cards/viral-play-dumb.mdmarkdown2.8 KB
knowledge/cards/viral-replies.mdmarkdown722 B
knowledge/cards/visual-density-and-evidence.mdmarkdown2.8 KB
knowledge/cards/voice-peer-stance.mdmarkdown2.7 KB
knowledge/cards/wechat-decide.mdmarkdown746 B
knowledge/cards/wechat-explain.mdmarkdown820 B
knowledge/cards/wechat-plugin-and-review.mdmarkdown2.5 KB
knowledge/cards/wechat-story.mdmarkdown798 B
knowledge/cards/x-adapt.mdmarkdown643 B
knowledge/cards/x-argument.mdmarkdown770 B
knowledge/cards/x-evidence.mdmarkdown608 B
knowledge/index.jsonconfig39.9 KB
package.jsonmanifest445 B
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/platform-cover-specs.mdmarkdown7.4 KB
references/platform-operations.mdmarkdown2.5 KB
references/publish-checklist.mdmarkdown2.2 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
references/workspace.mdmarkdown2.3 KB
references/x-delivery-contract.mdmarkdown3.6 KB
references/x-format.mdmarkdown3.5 KB
references/x-html-format.mdmarkdown6.8 KB
references/x-post-format.mdmarkdown2.5 KB
scripts/article_scaffold.pyscript5.6 KB
scripts/audit-provenance.pyscript14.9 KB
scripts/audit_css.pyscript1.1 KB
scripts/audit_docs.pyscript3.1 KB
scripts/audit_skill.pyscript3.1 KB
scripts/audit_styles.pyscript1.6 KB
scripts/check_article.pyscript13.9 KB
scripts/count_words.pyscript3.0 KB
scripts/de_ai_lint.pyscript41.5 KB
scripts/info_design_hints.pyscript14.2 KB
scripts/knowledge.pyscript11.8 KB
scripts/lint_x_post.pyscript20.0 KB
scripts/md2x-html.pyscript39.8 KB
scripts/md2x.pyscript15.4 KB
scripts/negative_tests.pyscript10.5 KB
scripts/package_skill.pyscript6.6 KB
scripts/revise_check.pyscript15.2 KB

references/x-html-format.md

View on GitHub
# x-html-format.md · md2x-html.py 转换规则

`scripts/md2x-html.py` 把 Markdown 原稿转成**单文件 HTML**(内联样式 + 图片 base64 内嵌,
无外部依赖),浏览器打开即用。对标 `md2wechat` 的公众号体验:页顶「一键复制全文」。

## X 文章编辑器语法

以实测粘贴效果为准:

| 原稿元素 | HTML 输出 | 粘贴进 X 后的表现 |
|---|---|---|
| `#`(首个) | `h1.no-paste`(页面展示) | **不进剪贴板**:手动填入 X 标题栏 |
| `##` / `###` | `h2` / `h3` | X 原生"标题 / 副标题"两级 |
| 段落(`**粗体**`、`` `代码` ``、裸链接) | `p`(strong/code/a 保留) | 原生富文本;行内 code 变纯文本;链接保留 |
| `- ` / `1. ` | `ul` / `ol` | 原生列表 |
| `> ` | `blockquote` | 原生引用块 |
| ``` 围栏(直出提示词) | `div.prompt > blockquote > code` + 「复制提示词」按钮 | 原生引用块。**粘贴流到此为止**:X 不识别粘贴的 `<pre>` 为代码块;读者侧一键复制只能来自 X 原生代码块(Insert → Code 手动建),见下节「提示词的复制链路(双通道)」 |
| `---` | `hr` | 可能被丢弃 → 发布时手动 Insert → 分割线 |
| GFM 表格 | `ul.xtable`(表头加粗首项) | **X 粘贴会丢弃 `<table>`**,转列表保内容;如需原生表格,走 X 的 Insert → 表格手动建 |
| 独占一行的 `![说明](images/xx.png)`(源稿没有 `[图N]` 时) | 按文档顺序换成 `[图N]` 后同下一行处理;远程图片跳过并告警 | 同下 |
| 图片下一行(可隔一个空行)的「来源:……」 | `p.src` 小号灰字图注 | 作为普通段落随正文复制 |
| `[图N]` 独占一行 | `<figure>`:内嵌 data-URI 图片 + `[图N]` 编号 + 「复制图片」「下载图片」按钮 | 复制全文时整张 figure 换成 `<p>[图N]</p>` 占位;图片逐张「复制图片」粘贴或下载上传 |
| 封面(`--cover`,缺省读 frontmatter 的 `cover`) | 页顶预览 + 下载(`.no-paste`) | 始终在 X 编辑器独立封面入口单独上传 |

「复制全文」前 JS 自动剔除所有 `<button>` 与 `.no-paste` 块(标题、封面预览),
并把每个 `figure.ximg` 换成 `[图N]` 占位段,剪贴板里只剩 X 可识别的语义标签:`h2/h3/p/ul/ol/blockquote/a/hr`。
工具栏三步话术:**① 标题填入 X 标题栏 → ② 一键复制全文 → ③ 粘贴到 X 正文**。

## 提示词的复制链路(双通道)

核实结论(2026-09-29,两处独立实测一致):

- X 原生代码块(Insert → Code 插入)**带原生复制按钮**,读者侧可一键复制(编辑器内真机验证,代码内容与复制按钮均保留)。
- 围栏代码**只能**走 Insert → Code 对话框,不依赖剪贴板 HTML 往返;
  粘贴 HTML 会丢弃 `<pre>`(实测笔记,2026-09-07)。

因此提示词的"复制"分两段:

- **通道 A(作者侧,发布前)**:`X长文.html` 里每个提示词块右上角「复制提示词」按钮,
  一键复制该块纯文本。这是你粘贴发布时取用提示词文本的入口。
- **通道 B(读者侧,发布后)**:X 编辑器里把提示词引用块手动转为原生代码块,
  读者才能一键复制。操作(每块约 10 秒):
  1. 在 HTML 里点该块「复制提示词」(文本已进剪贴板);
  2. X 编辑器对应位置 Insert → Code,新建原生代码块,粘贴;
  3. 删除原来的引用块(避免正文重复)。
  提示词密集型文章(如 N 条直出提示词)建议逐块转换;纯展示、无需读者取用的代码可跳过。

`X发布稿.txt` 里围栏已去标记、内容保留为纯文本,同样可作为通道 B 的文本来源。

## 图片约定

- 图片来源(新结构,默认):`python3 scripts/md2x-html.py <文章名>/<文章名>.md`,直接读源稿的
  `![]()`,路径相对 md 所在目录,按文档顺序嵌图;产物缺省写到 `<文章名>/out/X长文.html`。
  **禁止手工拼 `--images` 顺序**(文件名数字排序 ≠ 文档顺序,曾因此从某一节起整段错位)。
- 旧结构只读兼容:源稿是带 `[图N]` 的 `X长文.md` 时加 `--images-from 公众号稿.md`;
  有 `[图N]` 却没给图片来源会直接报错。
  脚本内置校验:`[图N]` 须连续编号且数量 = 图片数,否则报错退出。
- `--cover` 只做页顶预览 + 下载,**不占 `[图N]` 编号**
- 配图建议先压缩到宽 900px 左右的 JPEG(单张 <100KB),11 张图总 HTML 约 800KB,
  直接双击打开不卡
- 下载按钮用 JS 取同图 `src` 触发下载,data-URI 在 HTML 里只存一份(体积减半)

## 点击放大(lightbox)

- 正文每张配图、封面预览图均可点击,弹出全屏 lightbox 放大查看原图
- lightbox 内提供「新标签页打开原图」(Blob URL,绕开浏览器对 data: URL 顶层导航的限制)、
  「下载原图」按钮;**刻意不拦截右键菜单**,放大后可右键图片另存,或直接截图
- lightbox 位于 `#article` 之外,「一键复制全文」不会把它带入剪贴板

## 复制行为

- 「一键复制全文」按顺序降级,同时写 `text/html` + `text/plain`:
  ① 在点击的同步调用栈里挂 copy 事件 + `document.execCommand('copy')`(file://、非安全上下文、
  没给 clipboard-write 的 iframe 预览都能用;Safari 要求同步,所以放第一步);
  ② `navigator.clipboard.write([ClipboardItem])`,失败再 `writeText` 纯文本;
  ③ 全失败 → 自动全选 `#article`,toast 提示按 Cmd/Ctrl+C
- 「复制提示词」:同样先 execCommand,再 `writeText`
- 「复制图片」:`ClipboardItem({'image/png': Promise<Blob>})`,write 在同步栈里发起;非 PNG 先过 canvas。
  需要安全上下文(file:// 本地直接打开可以,部分 iframe 预览不行);失败提示改用「下载图片」
- 「下载图片/下载封面」:`a[download]` + data-URI,保底链路

## 已知限制(写进发布话术,不要过度承诺)

- 文本 + 格式一键复制可靠(富文本剪贴板,多家 X 发文技能同款做法)
- 全文复制不带图片(X 不认 data-URI 随文粘贴):粘贴后按 `[图N]` 占位逐张「复制图片」粘贴,
  或下载后上传,再删占位
- 聊天附件预览里打开时,富文本能复制,但「复制图片」可能被禁:下载 HTML 后用 Chrome/Safari 直接打开
- 封面始终在 X 编辑器单独上传(X 有独立封面入口),HTML 里只预览
- 分割线、代码块、表格三类 X 原生块**只能走 Insert 菜单**,粘贴流不承诺还原;
  本链路已做最大兼容(引用块/列表/hr),剩余手动补。
  其中代码块值得手动补:它是 X 侧唯一带读者一键复制(native copy button)的载体,
  提示词类内容建议走「提示词的复制链路」通道 B 逐块转换
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall