AI Skill MartBrowse skillsPromptsProgramsLearnWhat is a Skill?
 
← Back to list

Baoyu Markdown Formatter

Turns plain text or rough markdown into a polished, scannable article with frontmatter, titles and structure — without changing a single word of the original.

Content & WritingBeginner★ 27,160⑂ 2,961AI score 10/10Last updated: Nov 1, 2026

What it does

  • Reads your file and detects whether it is plain text or markdown; for existing markdown it asks whether to re-optimize the layout, keep the original structure, or only run typography fixes.
  • Writes a reader-perspective analysis (highlights, golden quotes, structural gaps, typos) to {filename}-analysis.md as the blueprint for formatting.
  • Builds YAML frontmatter (title, slug, summary, description, coverImage) and offers 4–5 title candidates generated from hook formulas, with the strongest one marked as recommended.
  • Applies headings, bold, ordered/unordered lists, tables, blockquotes and separators according to explicit do/don't rules, saving {filename}-formatted.md (with timestamped backup of any previous output).
  • Runs scripts/main.ts via bun/npx to fix CJK–English spacing, CJK emphasis punctuation, optional fullwidth quotes, and to normalize frontmatter YAML.
  • Ends with a change report counting headings, bold markers, lists, tables and typo fixes.

Who it's for

  • Bloggers, newsletter authors and technical writers who publish markdown regularly.
  • Anyone cleaning up transcripts, meeting notes or raw drafts for publication.
  • Writers working with mixed CJK/English text who need consistent spacing and emphasis.
  • Static-site users (Astro, Hugo, Next.js MDX) who want consistent frontmatter every time.

Examples

  1. "Format markdown for draft.txt" → produces an analysis file, prompts for a title, and outputs draft-formatted.md.
  2. For an already-structured post.md, choose option 3 (typography only) → the script fixes spacing and emphasis in place, no extra copy.
  3. A wall-of-text essay → buried parallel points become bullet lists, a prose comparison becomes a table, and key conclusions get bolded while the wording stays untouched.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/JimLiu/baoyu-skills/HEAD/skills/baoyu-format-markdown/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

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 AI 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 /tmp/baoyu-skills && mkdir -p ~/.claude/skills && cp -r /tmp/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 run node -v to confirm Node.js is installed (this gives you npx). For faster runs, install bun: curl -fsSL https://bun.sh/install | bash.
  2. Clone the repository: git clone https://github.com/JimLiu/baoyu-skills.git
  3. Create the skills folder if needed: mkdir -p ~/.claude/skills
  4. Copy the skill in: cp -r baoyu-skills/skills/baoyu-format-markdown ~/.claude/skills/
  5. Restart Claude Code and verify baoyu-format-markdown appears in your skills list.
  6. Run Claude Code in the folder containing your document and ask: "format markdown for draft.txt".
  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