Publish Substack Article

This automates publishing Markdown articles to Substack by converting them to HTML and pasting into the editor as rich text. It handles the full workflow: extracts titles from frontmatter or headers, converts Markdown with proper code blocks and formatting, uses clipboard paste to preserve styling (direct fill would strip formatting), and saves everything as a draft. One notable quirk: Substack's editor doesn't support HTML tables, so it includes a preprocessing step to convert tables to PNG images via the diagram-to-image skill before uploading. Works with both Playwright and Chrome DevTools MCP servers, defaulting to Playwright. Useful if you write in Markdown but need Substack's rich editor for final review and publishing.

skills.sh installs: 609
GitHub stars: 139
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sugarforever/01coder-agent-skills --skill publish-substack-article --agent claude-code

Installs into .claude/skills of the current project.

Files

Publish Substack Article

Publish Markdown content to Substack post editor, converting Markdown to HTML and pasting as rich text. Saves as draft for user review before publishing.

Prerequisites

Browser automation MCP (either one):
- Chrome DevTools MCP (mcp__chrome-devtools__*)
- Playwright MCP (mcp__playwright__*)
User logged into Substack
Python 3 with markdown package (pip install markdown)
copy_to_clipboard.py script (shared from publish-zsxq-article skill)

Browser MCP Tool Mapping

This skill works with both Chrome DevTools MCP and Playwright MCP:

Action	Chrome DevTools MCP	Playwright MCP
Navigate	`navigate_page`	`browser_navigate`
Take snapshot	`take_snapshot`	`browser_snapshot`
Take screenshot	`take_screenshot`	`browser_take_screenshot`
Click element	`click`	`browser_click`
Fill text	`fill`	`browser_type`
Upload file	`upload_file`	`browser_file_upload`
Press key	`press_key`	`browser_press_key`
Evaluate JS	`evaluate_script`	`browser_evaluate`