将 Markdown 转换为 X 文章
将提供的 Markdown 内容转换为一份准确的、在手机上可读的、并且易于粘贴到 X 文章编辑器的 X 文章草稿。
核心规则
- 保留作者原意、事实性声明、数据、链接和整体立场。
- 在不暗中重写实质性内容的前提下,改进结构和呈现方式。
- 使用平实、专业的语言。避免宣传性的夸张和不必要的术语。
- 不要声称 X 支持直接导入 Markdown。将 HTML 视为可直接复制的富文本来源,而非上传格式。
- X 文章可以包含图片、视频、GIF、嵌入的 X 帖子以及链接。保留所有有意义的媒体项目及其预期位置。
- 不要暗示复制 HTML 会自动将媒体上传或嵌入到 X。告知用户在 X 文章编辑器中通过原生方式添加媒体。
- 偏好使用短段落、清晰的标题、列表、加粗强调、引用和链接。
- 不要在最终的发布草稿中使用 Markdown 表格。将每个表格行转换为一个简洁的要点,并为标签加粗。
- 移除明显的占位符、空章节、重复的分隔符和草稿注释。
- 对于不确定的事实或损坏的链接,进行标记,而不是自行编造更正。
工作流程
-
在编辑之前先完整阅读源内容。
-
识别标题、开头、小节层级、表格、链接、占位符、结尾以及所有富媒体。
-
按源顺序创建媒体清单:
- 图片和截图
- 图表和示意图
- 视频和 GIF 文件或链接
- 用于嵌入的 X 帖子 URL
- 标题、致谢、来源链接和替代文本
-
创建一个能够准确传达文章主题和价值的特定标题。
-
添加或完善一个简短的开头,说明该主题的重要性。不要添加未经支持的声明。
-
规范化层级:
- 使用一个文章标题。
- 使用章节标题表示主要观点。
- 仅当有助于导航时才使用子标题。
- 修正错误或不一致的编号。
-
提高移动端可读性:
- 每个段落保持一个主要观点。
- 拆解密集的段落。
- 对于并列项和流程,使用项目符号或编号列表。
- 只对最重要的短语进行加粗。
-
使用以下模式将表格转换为列表:
- **标签**:说明 -
使用下面的规则处理富媒体。
-
保留引用作为块引用,并保留有效的来源链接。
-
用一个简洁的总结来加强结尾。移除空白的推荐或资源章节。
-
在交付前执行验证清单。
富媒体规则
图片、截图、图表和示意图
- 将每张有意义的图片保留在最近的相关段落处。
- 保留有用的替代文本。仅在知道图片内容的情况下,改进模糊的替代文本,如
图片。 - 将标题、致谢和来源链接与替代文本分开保存。
- 在文件系统可访问时,验证本地图片文件是否存在。
- 保留远程图片 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 编辑器:实测
原样显示为文本,X 不解析。正确流:打开 x-article-ready.html → 全选复制 → 粘进 X 文章编辑器,标题/加粗/列表以富文本带过去。 - HTML 预览里的图片必须 base64 内嵌:相对路径引用在用户单开文件时必裂图。视频不内嵌,留虚线插入标记,用户在编辑器手动上传。
- X 文章封面 1600×900(16:9),feed 预览裁得更紧,关键内容居中;跟微信封面(900×500,订阅列表缩略图)流量逻辑不同,要区分设计。中文标题照旧 PIL 精确排。
- 发布需要 Premium 及以上订阅;X Articles 支持正文任意位置内嵌多个视频。