md-to-zhihu

Convert Markdown documents to Zhihu format by removing YAML front matter and promoting headings.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/cc01cc/cmtx-project --skill md-to-zhihu-cc01cc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md-to-zhihu
Source: https://github.com/cc01cc/cmtx-project/tree/main/.kilo/skills-repo/cmtx/md-to-zhihu
Command: npx skills add https://github.com/cc01cc/cmtx-project --skill md-to-zhihu-cc01cc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Converting Markdown articles into Zhihu-ready formats can be tedious due to YAML front matter removal and heading realignment. This Skill automates the process to ensure compatibility with Zhihu publication standards and reduces manual editing time.

Core Features & Use Cases

  • Remove YAML Front Matter from Markdown documents to satisfy Zhihu's format requirements.
  • Promote heading levels uniformly (e.g., turning ## into #, ### into ##) to match Zhihu's preferred structure.
  • Provide a conversion script and clear manual steps for cases where automation is not possible, enabling seamless publication workflows for bloggers and content teams.
  • Use case: Prepare a standard blog post for Zhihu publication with a single run of the script to generate a Zhihu-compatible version.

Quick Start

Run the conversion script on a Markdown file to generate a Zhihu-ready version.

Frequently Asked Questions about md-to-zhihu

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

FAQPage Schema
How do I convert Markdown to Zhihu format by removing YAML front matter?

To convert Markdown to Zhihu format, this tool automatically removes YAML front matter and promotes heading levels to meet Zhihu publication standards. It processes standard Markdown documents, eliminating manual metadata deletion and structural realignment.

Why does Zhihu require heading promotion when publishing Markdown articles?

Zhihu requires heading promotion because its platform structure prefers different heading hierarchies than standard Markdown. This tool adjusts headings uniformly, such as turning double hashes into single hashes, to match Zhihu's preferred content structure and ensure proper formatting.

What is the best way to prepare a blog post for Zhihu publication?

The best way to prepare a blog post for Zhihu publication is running an automated conversion script on the Markdown file. This generates a Zhihu-ready version by stripping YAML front matter and realigning heading levels in a single execution.

Does the Markdown to Zhihu conversion work with KiloCode conventions?

Yes, the Markdown to Zhihu conversion works specifically with documents following KiloCode conventions. It handles the required heading promotion and YAML front matter removal to ensure compatibility with Zhihu publication standards for these files.

What are the limitations of automated Markdown conversion for Zhihu?

A limitation of automated Markdown conversion is potential edge cases where the script fails. However, the tool provides clear manual fallback steps for heading promotion and front matter removal to ensure the Zhihu publication workflow continues seamlessly.