Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Baoyu Markdown Formatter

Turns plain text or rough markdown into a clean, scannable article with frontmatter, headings, lists and tables — without changing a single word of the original.

Content & WritingBeginner★ 24,749⑂ 2,764AI score 8/10Last updated: Jul 4, 2026

What it does

  • Detects whether the target file is plain text or already markdown, and for markdown offers three modes: full optimization, keep existing structure, or typography-only.
  • Writes a reader-perspective analysis file ({filename}-analysis.md) covering highlights, golden quotes, structure gaps and formatting issues before touching the text.
  • Builds or completes YAML frontmatter (title, slug, summary, description, coverImage) and proposes 4–5 title candidates based on hook formulas.
  • Applies headings, bold, lists, tables, blockquotes and code markers under a strict rule: never add, delete or rewrite content (only obvious typos are fixed).
  • Runs scripts/main.ts for typography cleanup — CJK/English spacing, emphasis punctuation fixes, optional fullwidth quotes — then prints a detailed change report.

Who it's for

  • Bloggers, newsletter authors and technical writers who repeatedly hand-format drafts
  • Anyone converting transcripts or meeting notes from walls of prose into readable docs
  • Writers mixing CJK and English who need consistent spacing and punctuation
  • Static-site users who want complete frontmatter metadata generated automatically

Examples

  1. Clean up a transcript: "format markdown for draft.txt" → you get draft-analysis.md plus draft-formatted.md with headings and lists.
  2. Prep a blog post: for an existing post.md, pick from five suggested titles and receive auto-written summary and description fields.
  3. Typography only: when the layout is already fine, choose option 3 so the script just fixes spacing and emphasis in place on the original file.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/baoyu-format-markdown folder from the GitHub repo JimLiu/baoyu-skills into my ~/.claude/skills/baoyu-format-markdown/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/JimLiu/baoyu-skills.git && mkdir -p ~/.claude/skills && cp -r baoyu-skills/skills/baoyu-format-markdown ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and go to your home directory: cd ~
  2. Clone the repository: git clone https://github.com/JimLiu/baoyu-skills.git
  3. Create the skills folder: mkdir -p ~/.claude/skills
  4. Copy just this skill: cp -r baoyu-skills/skills/baoyu-format-markdown ~/.claude/skills/
  5. Make sure the script runtime exists: run bun --version; if missing, install with curl -fsSL https://bun.sh/install | bash, or rely on npx -y bun if Node.js is installed.
  6. Restart Claude Code and say something like "format this markdown file" to trigger the skill.
  7. (Optional) To skip the interactive title/summary prompts, create ~/.baoyu-skills/baoyu-format-markdown/EXTEND.md containing auto_select: true.
View source on GitHub ↗License: MIT