zenn-qiita-crosspost-workflow

Convert Zenn articles to Qiita syntax and post via publish.py CLI.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shimo4228/claude-code-learned-skills --skill zenn-qiita-crosspost-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zenn-qiita-crosspost-workflow
Source: https://github.com/shimo4228/claude-code-learned-skills/tree/main/skills/zenn-qiita-crosspost-workflow
Command: npx skills add https://github.com/shimo4228/claude-code-learned-skills --skill zenn-qiita-crosspost-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, python-frontmatter, and includes scripts (resource) components.

What problem does it solve?

Cross-posting Zenn articles to Qiita is error-prone due to platform-specific syntax, link handling, and publish-state differences. This workflow provides an automated conversion and posting pipeline to keep content in sync across platforms.

Core Features & Use Cases

  • Automated conversion of Zenn-formatted content to Qiita-compatible syntax, including supported mappings like :::message to blockquote and topics to tags.
  • A single source of truth in articles/ with a CLI workflow (publish.py) that transforms and posts, with optional dry-run for safe testing.
  • GitHub-ready deployment and platform-specific adaptations to streamline multi-platform publishing.

Quick Start

Prepare a Zenn article in articles/ and run the publish.py script to cross-post it to Qiita.

Frequently Asked Questions about zenn-qiita-crosspost-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cross-post articles from Zenn to Qiita automatically?

You can cross-post Zenn articles to Qiita automatically by running the publish.py CLI script, which transforms Zenn-formatted markdown and posts it to Qiita through an automated conversion pipeline.

What syntax differences are handled when converting Zenn markdown to Qiita?

The conversion handles platform-specific syntax differences including mapping Zenn's :::message blocks to Qiita blockquotes, converting topics to tags, and ensuring link compatibility across both platforms.

Can I test cross-posting to Qiita without actually publishing the article?

Yes, you can use the dry-run testing feature in the publish.py CLI to safely test the markdown transformation and cross-posting pipeline before actually publishing to Qiita.

What is the best way to manage multi-platform publishing across Zenn and Qiita?

The best way is maintaining a single source of truth in the articles/ directory and using the publish.py CLI workflow, which supports GitHub-based deployment to streamline multi-platform publishing.

Do I need httpx and python-frontmatter to run the Zenn Qiita cross-posting workflow?

Yes, the workflow requires httpx and python-frontmatter dependencies to handle frontmatter mapping and HTTP requests for posting transformed content to the Qiita API.

Why does my Zenn article format break when I manually post it to Qiita?

Manual posting breaks formatting because Zenn and Qiita have platform-specific syntax differences; the automated pipeline solves this by handling frontmatter mapping and syntax conversion during cross-posting.