skills.rest
augustscl
augustsclCOMMUNITY
Explore all skills by this author →
GitHub

baoyu-format-markdown

Format plain text and Markdown files into well-structured Markdown.

2|Updated Apr 6, 2026
Search Tags:#typography#markdown#frontmatter#format#remark#autocorrect
One-click install
npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill baoyu-format-markdown-augustscl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: baoyu-format-markdown
Source: https://github.com/augustscl/awesome-xiawang-skills/tree/main/baoyu-format-markdown
Command: npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill baoyu-format-markdown-augustscl

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Converts unstructured plain text or inconsistently formatted Markdown into clean, readable, and well-structured Markdown so readers can grasp key points quickly without changing the original content.

Core Features & Use Cases

  • Frontmatter handling: Detects existing YAML frontmatter or creates it, and formats it consistently.
  • Title & summary generation: Proposes multiple title and summary candidates (or auto-selects based on EXTEND.md).
  • Structural analysis & formatting: Identifies headings, extracts lists from prose, marks code and commands, and improves heading hierarchy while preserving all original words.
  • Typography & CJK support: Runs remark plugins and an autocorrect script to fix CJK/English spacing, emphasis punctuation, and optional quote replacement.
  • Use Case: Prepare a blog draft or technical note for publishing by normalizing frontmatter, improving scannability, and applying consistent typography.

Quick Start

Please format the file article.md into a well-structured Markdown file 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 format plain text into well-structured Markdown with YAML frontmatter?▼

Formatting plain text into structured Markdown involves detecting or generating YAML frontmatter, proposing title and summary candidates, and normalizing headings and lists while preserving all original words.

What is the best way to fix CJK and English spacing issues in Markdown files?▼

Fixing CJK and English spacing in Markdown files is handled by applying remark plugins and an autocorrect script that adjust spacing, emphasis punctuation, and optional quote replacements automatically.

Does remark-frontmatter support generating missing YAML frontmatter for blog drafts?▼

Yes, remark-frontmatter is used to detect existing YAML frontmatter or generate it for blog drafts and technical notes, ensuring consistent formatting across your Markdown documentation.

Can I use remark to improve heading hierarchy and extract lists from prose?▼

You can use remark to perform structural analysis on your Markdown, identifying headings, extracting lists from prose, marking code and commands, and improving heading hierarchy without altering content.

How do I format a technical note for publishing without changing the original content?▼

Formatting a technical note for publishing without changing content is achieved by applying structural formatting adjustments and typography fixes via remark plugins, ensuring the original words remain fully preserved.

Related Skills

Explore More Content & Communication Skills→
open-foxopen-fox
54

baoyu-format-markdown

Format plain text or Markdown into structured documents with preserved metadata.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
JackiexiaoJackiexiao
1

baoyu-format-markdown

Formats plain text and markdown files with frontmatter, headings, and typography fixes.

Community
Intermediate
Dante-danDante-dan

baoyu-format-markdown

Format plain text and markdown files into structured documents with frontmatter and typography fixes.

Community
Intermediate