baoyu-format-markdown

Formats plain text or markdown files into structured markdown with frontmatter and typography.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/makerjackie/jackie-skills-starter --skill baoyu-format-markdown-makerjackie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baoyu-format-markdown
Source: https://github.com/makerjackie/jackie-skills-starter/tree/main/skills/baoyu-format-markdown
Command: npx skills add https://github.com/makerjackie/jackie-skills-starter --skill baoyu-format-markdown-makerjackie

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 users have plain text or poorly formatted markdown lacking frontmatter, proper headings, lists, and typography, making content hard to read and publish.

Core Features & Use Cases

  • Frontmatter generation: Adds or fixes YAML metadata such as title, slug, summary, and coverImage.
  • Structural formatting: Inserts titles, headings, bold highlights, lists, code blocks, and blockquotes where appropriate.
  • Typography enhancements: Applies CJK/English spacing, emphasis fixes, and optional fullwidth quote replacement via bundled scripts.
  • Workflow flexibility: Detects content type, offers optimization choices, and outputs a new file named {filename}-formatted.md.

Quick Start

Use the baoyu-format-markdown skill to format example.md and generate example-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 add frontmatter and format markdown files?

To format markdown files, this skill uses bundled scripts to add YAML frontmatter, fix headings, and apply typography rules, outputting a new formatted markdown file. It requires Node.js to run the automation scripts.

What is the best way to fix CJK and English spacing in markdown?

Fixing CJK and English spacing in markdown is handled by the remark-cjk-friendly dependency, which automatically adjusts typography and spacing during the formatting process to ensure standardized text output.

Can I customize frontmatter generation for blog publishing?

Customizing frontmatter for blog publishing is supported by adding an optional EXTEND.md configuration file, allowing you to define specific metadata fields like title, slug, summary, and coverImage.

How do I convert plain text into structured markdown with headings and lists?

Converting plain text into structured markdown involves detecting the content type and inserting appropriate headings, bold highlights, lists, code blocks, and blockquotes using the unified remark parsing pipeline.

Does markdown formatting work with GitHub Flavored Markdown and YAML frontmatter?

Formatting works with GitHub Flavored Markdown and YAML frontmatter by utilizing the remark-gfm and remark-frontmatter dependencies to parse and stringify the markdown content accurately.

What are the limitations of automating markdown typography fixes via CLI scripts?

Limitations of automating markdown typography fixes include relying on Node.js and bundled scripts, and the process outputs a new formatted file rather than overwriting the original markdown source.