Community寫作與編輯github.com

pinosong/md-to-x-article-skill

將 Markdown 長文內容轉換為精美的 X Article 發布草稿。當使用者要求轉換、改編、格式化或最佳化 Markdown 以用於 X Articles,包括產出可供直接複製的富文字 HTML 版本及編輯後的 Markdown 版本時使用。

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

此技能專門用於將 Markdown 格式的長文內容轉換成可直接在 X(原 Twitter)Article 編輯器中使用的高品質草稿。它能保留原文的語意、事實、數據與連結,同時最佳化結構與行動裝置可讀性。技能支援多種平台(如 Claude Code、Cursor 等),透過一系列嚴格的規則與工作流程,包括建立媒體清單、正規化標題層級、將表格轉換為列表、處理圖片與影片等媒體,並產出兩個輸出檔案:一份是可供審閱與修改的 Markdown 檔案(x-article-ready.md),另一份是可直接在瀏覽器中開啟並複製至 X Article 編輯器的乾淨 HTML 檔案(x-article-ready.html)。此技能特別提醒使用者不要直接將 Markdown 貼入 X 編輯器,且 HTML 中的圖片須使用 base64 內嵌以避免失效。根據實測補充,X Article 的封面圖片建議為 1600×900(16:9)比例,且發布需要 Premium 以上訂閱。

相容平台~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 Article

將提供的 Markdown 轉換成一份精確、在行動裝置上可讀、且易於貼入 X Article 編輯器的草稿。

核心規則

  • 保留作者的原意、事實陳述、數字、連結以及整體立場。
  • 在不悄悄改寫實質內容的前提下,改善結構與呈現方式。
  • 使用平實專業的語言。避免促銷誇飾與不必要的術語。
  • 不得聲稱 X 支援直接匯入 Markdown。將 HTML 視為可直接複製的富文字來源,而非上傳格式。
  • X Articles 可以包含圖片、影片、GIF、嵌入式 X 貼文以及連結。保留所有有意義的媒體項目及其預定位置。
  • 不得暗示複製 HTML 會將媒體上傳或嵌入到 X 中。告知使用者應在 X Article 編輯器中以原生方式添加媒體。
  • 偏好短段落、清晰的標題、列表、粗體強調、引用區塊與連結。
  • 在最終發布草稿中不得使用 Markdown 表格。將每個表格列轉換為帶有粗體標籤的簡潔項目符號。
  • 移除明顯的佔位符、空白章節、重複分隔線與草稿備註。
  • 若有疑慮的事實或失效連結,請標示出來,而非自行捏造修正。

工作流程

  1. 在編輯前完整閱讀原始資料。

  2. 識別標題、開場白、章節層級結構、表格、連結、佔位符、結尾以及所有豐富媒體。

  3. 依照原始順序建立媒體清單:

    • 圖片與螢幕截圖
    • 圖表與示意圖
    • 影片與 GIF 檔案或連結
    • 用於嵌入的 X 貼文 URL
    • 說明文字、版權資訊、來源連結與替代文字
  4. 建立一個能準確傳達文章主題與價值的特定標題。

  5. 添加或潤飾簡潔的開場白,說明該主題為何重要。請勿添加未經證實的主張。

  6. 正規化階層結構:

    • 使用一個文章標題。
    • 對主要觀點使用章節標題。
    • 僅在能改善導覽時使用子標題。
    • 修正錯誤或不一致的編號。
  7. 改善行動裝置可讀性:

    • 每個段落保持一個主要想法。
    • 拆解密集的段落。
    • 對並列項目與步驟使用項目符號或編號列表。
    • 僅對最重要的短語使用粗體。
  8. 使用以下模式將表格轉換為列表:

    - **標籤**:說明

  9. 根據下方規則處理豐富媒體。

  10. 將引文保留為引用區塊,並保留有效的來源連結。

  11. 以簡潔總結強化結尾。移除空白的推薦或資源章節。

  12. 在交付前執行驗證檢查清單。

豐富媒體規則

圖片、螢幕截圖、圖表與示意圖

  • 將每張有意義的圖片保留在最近的相關段落旁。
  • 保留有用的替代文字。只有在確定圖片內容時,才改善如 image 這類模糊的替代文字。
  • 將說明文字、版權資訊與來源連結與替代文字分開保存。
  • 在可存取檔案系統時,驗證本地圖片檔案是否存在。
  • 保留遠端圖片 URL 作為參考,但不要依賴熱連結圖片進行最終發布。
  • 在 HTML 預覽中,使用 img、alt 與可選的 figcaption 來渲染可存取的圖片。
  • 在 Markdown 輸出中,保留標準圖片語法。
  • 當原始資料中有合適的候選圖片時,建議使用一張有力的相關標題圖片。除非要求,否則不要自行發想或生成圖片。

影片與 GIF

  • 保留原始 URL 或檔案引用及其預定位置。

  • 在兩種輸出中都添加清晰的插入標記,例如:

    [在 X 編輯器中插入影片:產品展示 — 來源:./demo.mp4]

  • 不要將影片或 GIF 轉換為自動播放的 HTML 嵌入元素。

  • 建議在 X Article 編輯器中以原生方式上傳。

X 貼文

  • 偵測 x.com 與 twitter.com 的狀態 URL。
  • 保留該 URL,並標記為在 X Article 編輯器中原生嵌入貼文。
  • 除非使用者要求,否則不要用不支援的 iframe 或複製的螢幕截圖來取代 X 貼文。

遺失或無法存取的媒體

  • 切勿默默移除遺失的媒體。
  • 保留包含原始路徑或 URL 的插入標記。
  • 在交付摘要中報告遺失、無法存取或不支援的項目。

媒體密度

  • 使用媒體來說明、示範或提供證據。
  • 避免在沒有明確目的的情況下放置多個裝飾性圖片。
  • 保持說明文字簡潔,並確保每個視覺元素在上下文中易於理解。

必要輸出

除非使用者要求其他格式,否則請在工作目錄中建立兩個檔案:

  • x-article-ready.md:經編輯、可讀的 Markdown,供審閱與未來修訂。
  • x-article-ready.html:乾淨的富文字網頁,使用者可在瀏覽器中開啟並複製到 X Article 編輯器。

HTML 版本必須:

  • 使用語義化元素,例如 article、h1、h2、h3、p、strong、em、blockquote、ul、ol、li 與 a。
  • 在適當情況下使用 figure、img 與 figcaption 呈現圖片。
  • 包含 UTF-8 與響應式 viewport 中繼資料。
  • 使用簡潔的內聯 CSS,以便在瀏覽器中舒適檢視。
  • 避免使用 JavaScript、外部依賴、追蹤程式碼以及複製後無法保留的裝飾性元素。
  • 在桌面與行動裝置上都能清晰顯示。
  • 對影片、GIF、遺失媒體以及原生 X 貼文嵌入顯示可見的插入標記。

若環境無法建立檔案,請直接回傳潤飾後的草稿,並簡短說明限制。

驗證檢查清單

在交付前,請驗證:

  • 標題僅出現一次。
  • 標題層級一致。
  • 無佔位符或空白章節。
  • 無 Markdown 表格或僅含分隔線的行。
  • 列表完整且順序正確。
  • 粗體與斜體標記成對出現。
  • 連結已保留且未變形。
  • 所有豐富媒體皆出現在媒體清單中,並保留在文章的正確位置。
  • 圖片的替代文字、說明文字、版權資訊與來源連結在可用時均已保留。
  • 本地媒體路徑存在,或遺失項目已清楚報告。
  • 影片、GIF 與 X 貼文的插入標記已放置在需要原編輯器操作的位置。
  • 引用已清楚區分。
  • 未意外變更任何實質主張、數字或結論。
  • 文章結尾有明確收束,而非消失在空白章節中。
  • HTML 可成功開啟,且包含與 Markdown 版本相同的文章內容。

交付

簡短說明:

  • 建立了哪些檔案。
  • 主要的結構性變更。
  • HTML 版本應在瀏覽器中開啟,然後複製到 X Article 編輯器。
  • 哪些圖片、影片、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 支援在正文任意位置內嵌多個影片。

相關技能