Overview
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.
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
Installation
Add baoyu-format-markdown to your agent with:
/plugin marketplace add JimLiu/baoyu-skillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
License
baoyu-format-markdown is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in JimLiu/baoyu-skills, an established project with 25,129 GitHub stars
- Works with Claude Code, Codex
- Actively maintained — repository updated in the last 90 days
Author
Topics
Alternatives to baoyu-format-markdown
Similar skills from other repositories:
Compare baoyu-format-markdown alternatives side by side →
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.
- Which agents does baoyu-format-markdown work with?
- baoyu-format-markdown lists Claude Code and Codex — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- 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.
