在開發 DeepSeek Harness 智能體時，處理內容分發是常見需求。直接調用 Notion API 需要編寫複雜的 JSON 構建邏輯，且需要處理 API Token 的存儲與刷新。這個插件通過 MCP 服務器，把 Markdown 文本直接轉換爲 Notion API 接受的 JSON 格式，簡化了集成流程。
插件定位¶
這是一個由 xby-skill 維護的 MCP 服務器插件，用於將 Markdown 內容轉換爲 Notion API 兼容格式。它主要面向內容管理和開發集成場景，旨在減少開發者編寫轉換邏輯的代碼量。
核心功能¶
插件提供了兩個核心工具：
set_xby_apikey：在聊天中設置 API 密鑰。該密鑰會自動持久化保存，重啓 DSH 進程後依然有效。markdown_to_notion：將 Markdown 文本內容轉換爲 Notion 頁面內容所需的 JSON 結構。
安裝與啓用¶
在終端中執行以下命令即可安裝插件：
dsh plugin --profile web add github:xby_skill/xby-markdown-to-notion
安裝完成後，重啓 DSH 進程，插件即可加載使用。
典型用法¶
使用該插件前，需要先完成 API 密鑰的獲取。
- 獲取密鑰：前往 小笨羊官網 註冊並獲取 API 密鑰。
- 設置密鑰：在對話中調用
set_xby_apikey工具，傳入你的 API 密鑰。 - 執行轉換：調用
markdown_to_notion工具，將準備好的 Markdown 文本作爲參數傳入。
適用場景與注意事項¶
該插件適合需要將 Markdown 文檔快速同步到 Notion 系統的開發者或內容創作者。
注意事項：
* 插件以當前 DSH 進程的權限運行。在安裝前，建議檢查插件的源碼倉庫（GitHub）以確認其行爲符合預期。
* 必須先在小笨羊官網完成註冊並獲取 API 密鑰才能正常使用。
該插件提供了輕量級的轉換能力，降低了集成 Notion 的門檻。更多細節可參考插件目錄或 GitHub 倉庫。
