Community写作与编辑github.com

pinosong/md-to-x-article-skill

将 Markdown 长篇内容转换为可直接用于 X 文章发布的精炼草稿。当用户要求转换、改编、格式化或优化 Markdown 以适应 X 文章时使用,包括生成一份可直接复制的富文本 HTML 版本和一份编辑后的 Markdown 版本。

md-to-x-article-skill 是什么?

该技能将 Markdown 格式的长篇内容转换为适用于 X 文章的精炼发布草稿。它专注于保留作者原意、事实性声明、数据、链接和整体立场,同时优化结构和呈现方式,以提高在移动设备上的可读性。该技能会生成两个输出文件:一个用于审查和未来修订的可读性强的 Markdown 文件(x-article-ready.md),以及一个可直接在浏览器中打开并复制到 X 文章编辑器中的简洁富文本 HTML 文件(x-article-ready.html)。它严格遵循一套核心规则,例如将 Markdown 表格转换为带加粗标签的要点列表,移除所有占位符和草稿注释,并为每篇内容创建媒体清单(包括图片、视频、GIF 和嵌入的 X 帖子)。该技能还会在文本中插入清晰标记(例如 `[在 X 编辑器中插入视频]`),提示用户需要在 X 文章编辑器中本地上传或嵌入哪些多媒体内容。此外,它提供了一套详细的验证清单,以确保标题、标题层级、列表、链接和媒体位置等所有格式元素在交付前都正确无误。最后,该技能还会提供一份交付摘要,说明所做的结构修改以及需要人工审查的潜在问题。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add pinosong/md-to-x-article-skill

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

alt

文档

将 Markdown 转换为 X 文章

将提供的 Markdown 内容转换为一份准确的、在手机上可读的、并且易于粘贴到 X 文章编辑器的 X 文章草稿。

核心规则

  • 保留作者原意、事实性声明、数据、链接和整体立场。
  • 在不暗中重写实质性内容的前提下,改进结构和呈现方式。
  • 使用平实、专业的语言。避免宣传性的夸张和不必要的术语。
  • 不要声称 X 支持直接导入 Markdown。将 HTML 视为可直接复制的富文本来源,而非上传格式。
  • X 文章可以包含图片、视频、GIF、嵌入的 X 帖子以及链接。保留所有有意义的媒体项目及其预期位置。
  • 不要暗示复制 HTML 会自动将媒体上传或嵌入到 X。告知用户在 X 文章编辑器中通过原生方式添加媒体。
  • 偏好使用短段落、清晰的标题、列表、加粗强调、引用和链接。
  • 不要在最终的发布草稿中使用 Markdown 表格。将每个表格行转换为一个简洁的要点,并为标签加粗。
  • 移除明显的占位符、空章节、重复的分隔符和草稿注释。
  • 对于不确定的事实或损坏的链接,进行标记,而不是自行编造更正。

工作流程

  1. 在编辑之前先完整阅读源内容。

  2. 识别标题、开头、小节层级、表格、链接、占位符、结尾以及所有富媒体。

  3. 按源顺序创建媒体清单:

    • 图片和截图
    • 图表和示意图
    • 视频和 GIF 文件或链接
    • 用于嵌入的 X 帖子 URL
    • 标题、致谢、来源链接和替代文本
  4. 创建一个能够准确传达文章主题和价值的特定标题。

  5. 添加或完善一个简短的开头,说明该主题的重要性。不要添加未经支持的声明。

  6. 规范化层级:

    • 使用一个文章标题。
    • 使用章节标题表示主要观点。
    • 仅当有助于导航时才使用子标题。
    • 修正错误或不一致的编号。
  7. 提高移动端可读性:

    • 每个段落保持一个主要观点。
    • 拆解密集的段落。
    • 对于并列项和流程,使用项目符号或编号列表。
    • 只对最重要的短语进行加粗。
  8. 使用以下模式将表格转换为列表:

    - **标签**:说明

  9. 使用下面的规则处理富媒体。

  10. 保留引用作为块引用,并保留有效的来源链接。

  11. 用一个简洁的总结来加强结尾。移除空白的推荐或资源章节。

  12. 在交付前执行验证清单。

富媒体规则

图片、截图、图表和示意图

  • 将每张有意义的图片保留在最近的相关段落处。
  • 保留有用的替代文本。仅在知道图片内容的情况下,改进模糊的替代文本,如 图片。
  • 将标题、致谢和来源链接与替代文本分开保存。
  • 在文件系统可访问时,验证本地图片文件是否存在。
  • 保留远程图片 URL 以供参考,但不要依赖热链接图片用于最终发布。
  • 在 HTML 预览中,使用 img、alt 和可选的 figcaption 渲染无障碍图片。
  • 在 Markdown 输出中,保留标准的图片语法。
  • 当源内容中有合适的候选人时,推荐一张引人注目的、相关的标题图片。除非用户要求,否则不要虚构或生成。

视频和 GIF

  • 保留原始 URL 或文件引用及其预期位置。

  • 在两个输出中添加一个清晰的插入标记,例如:

    [在 X 编辑器中插入视频:产品演示 — 来源:./demo.mp4]

  • 不要将视频或 GIF 转换为自动播放的 HTML 嵌入。

  • 建议在 X 文章编辑器中进行原生上传。

X 帖子

  • 检测 x.com 和 twitter.com 的状态 URL。
  • 保留该 URL,并标记为在 X 文章编辑器中进行原生帖子嵌入。
  • 除非用户要求,否则不要用不支持的 iframe 或复制的截图替换 X 帖子。

缺失或不可访问的媒体

  • 永远不要无声地移除缺失的媒体。
  • 保留一个插入标记,其中包含原始路径或 URL。
  • 在交付摘要中报告缺失、不可访问或不支持的项目。

媒体密度

  • 使用媒体来解释、演示或提供证据。
  • 避免在无明显目的的情况下将多个装饰性图片放在一起。
  • 保持标题简洁,并确保每个视觉元素在上下文中是可以理解的。

必需输出

除非用户要求其他格式,否则在当前工作区中创建两个文件:

  • x-article-ready.md:编辑过的、可读性好的 Markdown,用于审查和未来修订。
  • x-article-ready.html:一个干净的富文本页面,用户可以在浏览器中打开并复制到 X 文章编辑器中。

HTML 版本必须:

  • 使用语义化元素,如 article、h1、h2、h3、p、strong、em、blockquote、ul、ol、li 和 a。
  • 在适用时使用 figure、img 和 figcaption 处理图片。
  • 包含 UTF-8 和响应式视口元数据。
  • 使用简单的内联 CSS,以方便舒适的浏览器审查。
  • 避免使用 JavaScript、外部依赖、跟踪以及复制后无法保留的装饰性元素。
  • 在桌面端和移动端上都能清晰显示。
  • 为视频、GIF、缺失媒体和原生 X 帖子嵌入显示可见的插入标记。

如果环境无法创建文件,则直接返回精炼后的草稿,并简要说明限制。

验证清单

在交付之前,验证:

  • 标题只出现一次。
  • 标题级别一致。
  • 没有占位符或空章节残留。
  • 没有 Markdown 表格或仅包含分隔符的行残留。
  • 列表完整且顺序正确。
  • 加粗和斜体标记成对出现。
  • 链接已保留且格式正确。
  • 所有富媒体都出现在媒体清单中,并且保持在文章的正确位置。
  • 图片的替代文本、标题、致谢和来源链接(如有)已保留。
  • 本地媒体路径存在,或者缺失的项目已明确报告。
  • 视频、GIF 和 X 帖子插入标记存在于需要原生编辑器操作的位置。
  • 引文已清晰区分。
  • 没有意外更改任何实质性声明、数据或结论。
  • 文章有明确的结尾,而不是逐渐消失到一个空白的章节。
  • HTML 文件可以成功打开,并且包含与 Markdown 版本相同的文章内容。

交付

简要说明:

  • 创建了哪些文件。
  • 所做的结构性主要更改。
  • HTML 版本应在浏览器中打开,然后复制到 X 文章编辑器中。
  • 哪些图片、视频、GIF 和 X 帖子必须在 X 中原生上传或嵌入。
  • 任何仍需要人工审查的事实、链接或格式问题。

本地实测补充(2026-10-17,DeepSeek 1017 文章转 X 实测)

  • 不要直接粘 Markdown 进 X 编辑器:实测 ![alt](路径) 原样显示为文本,X 不解析。正确流:打开 x-article-ready.html → 全选复制 → 粘进 X 文章编辑器,标题/加粗/列表以富文本带过去。
  • HTML 预览里的图片必须 base64 内嵌:相对路径引用在用户单开文件时必裂图。视频不内嵌,留虚线插入标记,用户在编辑器手动上传。
  • X 文章封面 1600×900(16:9),feed 预览裁得更紧,关键内容居中;跟微信封面(900×500,订阅列表缩略图)流量逻辑不同,要区分设计。中文标题照旧 PIL 精确排。
  • 发布需要 Premium 及以上订阅;X Articles 支持正文任意位置内嵌多个视频。

相关技能