baoyu-format-markdown

baoyu-format-markdown is an open-source docs skill for Claude Code and compatible agents, published by JimLiu. Its author describes it as: “Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layou…”. The project has 25k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add JimLiu/baoyu-skills`.

What baoyu-format-markdown does

Transforms plain text or markdown into well-structured, reader-friendly markdown. The goal is to help readers quickly grasp key points, highlights, and structure — without changing any original content.

Installation

Add baoyu-format-markdown to your agent with:

/plugin marketplace add JimLiu/baoyu-skills

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for baoyu-format-markdown is organised into these sections:

• User Input Tools
• Script Directory
• Preferences (EXTEND.md)
• Usage
• Workflow
• Step 1: Read & Detect Content Type
• Step 2: Analyze Content (Reader's Perspective)
• Step 3: Check/Create Frontmatter, Title & Summary
• Step 4: Format Content
• Step 5: Save Formatted File
• Step 6: Execute Typography Script
• Step 7: Completion Report

When to use it

Reach for baoyu-format-markdown when you want docs help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Clear MIT license — safe to read and adapt
• Ships in JimLiu/baoyu-skills, an established project with 25,129 GitHub stars
• Actively maintained (recent commits)

Topics

Frequently asked questions

What does baoyu-format-markdown do?

Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.

How do I install baoyu-format-markdown?

Run /plugin marketplace add JimLiu/baoyu-skills in your agent, then reload your skills. Review the source at https://github.com/JimLiu/baoyu-skills before installing.

Is baoyu-format-markdown free to use?

Yes. baoyu-format-markdown is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.

Where does baoyu-format-markdown come from?

baoyu-format-markdown ships inside JimLiu/baoyu-skills, a repository that contains 23 catalogued skills in total. The repository's 25,129 GitHub stars apply to that whole collection, not to this skill on its own.