baoyu-format-markdown

Formats markdown articles with frontmatter, headings, lists, and CJK typography fixes.

Updated May 18, 2026
One-click install
npx skills add https://github.com/fts-pro/FTS-MMIS-AFRIKA --skill baoyu-format-markdown-fts-pro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: baoyu-format-markdown
Source: https://github.com/fts-pro/FTS-MMIS-AFRIKA/tree/main/.agent/skills/baoyu-format-markdown
Command: npx skills add https://github.com/fts-pro/FTS-MMIS-AFRIKA --skill baoyu-format-markdown-fts-pro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires remark-cjk-friendly, remark-frontmatter, remark-gfm, remark-parse, remark-stringify, unified, unist-util-visit, yaml, autocorrect-node, and includes scripts (resource) and references (resource) components.

What problem does it solve? Raw drafts and plain-text articles often lack structure, frontmatter metadata, and consistent CJK typography, making them hard to read and publish. This Skill analyzes content, adds titles, summaries, headings, bold, lists, and tables, then applies automated typography fixes without altering the original wording. ## Core Features & Use Cases - Content Analysis & Formatting: Reads an article, produces an analysis file of highlights and structural issues, then applies headings, bold, lists, tables, and blockquotes while preserving every original word. - Frontmatter & Title Generation: Creates or updates YAML frontmatter with title, slug, summary, and description, offering 4-5 title candidates based on proven hook formulas. - CJK Typography Script: Runs a remark-based script that fixes CJK emphasis punctuation, adds CJK/English spacing via autocorrect, optionally converts ASCII quotes to fullwidth quotes, and formats frontmatter YAML. - Use Case: You have a plain-text blog draft in Chinese mixed with English terms. Run this Skill to get a structured, publication-ready markdown file with a compelling title, summary, proper spacing, and clean typography saved as {filename}-formatted.md. ## Quick Start Format the article draft.md into a well-structured markdown file with frontmatter, title suggestions, and CJK typography fixes.

Frequently Asked Questions about baoyu-format-markdown

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

FAQPage Schema
How do I format a markdown article with proper headings and structure?▼

Provide the file path and the Skill analyzes the content, generates an analysis file, then adds headings, bold, lists, and tables without changing any original wording. The result is saved as {filename}-formatted.md.

How to fix CJK and English mixed text spacing in markdown?▼

The Skill runs a typography script using autocorrect-node that automatically adds proper spacing between CJK and English characters. Spacing is enabled by default and can be disabled with the --no-spacing flag.

Does the markdown formatter change my original content?▼

No, the core principle is to only adjust formatting and fix obvious typos. It never adds, deletes, or rewrites content, preserving the author's voice, tone, and every word.

What runtime do I need to run the formatting scripts?▼

The scripts require either bun or npx. If bun is installed it runs directly; otherwise npx -y bun is used as a fallback to execute the TypeScript entry point.

Can I skip the interactive title and summary selection?▼

Yes, set auto_select, auto_select_title, or auto_select_summary to true in an EXTEND.md preferences file. The Skill then automatically picks the best candidate without prompting.