baoyu-format-markdown

Format markdown documents with frontmatter, headings, and typographic fixes.

2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/neo-unicorn/neo-skills --skill baoyu-format-markdown-neo-unicorn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baoyu-format-markdown
Source: https://github.com/neo-unicorn/neo-skills/tree/main/baoyu-format-markdown
Command: npx skills add https://github.com/neo-unicorn/neo-skills --skill baoyu-format-markdown-neo-unicorn

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Many writers spend time manually adjusting markdown files—adding frontmatter, fixing headings, applying consistent bolding, lists, code blocks, and correcting CJK/English spacing. This skill automates those repetitive formatting steps so the content is instantly scannable and publication‑ready.

Core Features & Use Cases

  • Frontmatter & Title Generation: Detects or creates YAML frontmatter, infers a concise title and summary, and adds a slug if needed.
  • Structural Formatting: Analyzes the text to insert appropriate headings, bold key points, convert parallel sentences into lists, and wrap code snippets.
  • Typography Fixes: Runs CJK‑friendly spacing, emphasis punctuation correction, and optional full‑width quote replacement via the bundled scripts.
  • Use Case Example: Prepare a blog draft written in plain text; run the skill to produce a fully‑formatted markdown file with proper headings, a summary, and flawless typography ready for publishing.

Quick Start

Ask the skill to format your file “article.md” and save the result as “article-formatted.md”.

Frequently Asked Questions about baoyu-format-markdown

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

FAQPage Schema
How do I automatically format markdown files with proper frontmatter and titles?

To automatically format markdown, this skill analyzes your plain-text drafts to detect or generate YAML frontmatter, infer concise titles, and add summaries. It processes your files using Node.js scripts to produce publication-ready documents.

Can I fix CJK and English spacing issues in markdown documents automatically?

Yes, you can fix CJK and English spacing automatically using this skill. It applies CJK-friendly spacing, corrects emphasis punctuation, and optionally replaces full-width quotes by leveraging the remark-cjk-friendly library during processing.

What is the best way to convert plain text drafts into structured markdown for publishing?

The best way to convert plain text drafts into structured markdown is using this skill to insert appropriate headings, bold key points, and convert parallel sentences into lists. It transforms unstructured text into scannable, publication-ready markdown.

Does this markdown formatting tool support GitHub Flavored Markdown and frontmatter?

Yes, this markdown formatting tool supports GitHub Flavored Markdown and frontmatter. It uses the remark-gfm plugin to parse GFM syntax and the remark-frontmatter plugin to detect, create, or validate YAML frontmatter blocks.

How do I run the markdown formatting script on an existing file?

To run the markdown formatting script, ask the skill to process your target file like "article.md" and specify an output path such as "article-formatted.md". The script executes via Node.js using bun or npx to apply all formatting rules.

Why does my markdown formatting break when processing mixed CJK and English text?

Markdown formatting often breaks with mixed CJK and English text due to incompatible parsers. This skill solves that by using the remark-cjk-friendly plugin, which preserves correct spacing and prevents character corruption during the AST conversion process.