format-markdown

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

4|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/GPTtang/skill-atlas --skill format-markdown-gpttang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: format-markdown
Source: https://github.com/GPTtang/skill-atlas/tree/main/skills/writing/format-markdown
Command: npx skills add https://github.com/GPTtang/skill-atlas --skill format-markdown-gpttang

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?

This Skill streamlines the process of formatting plain text or markdown files, ensuring they have proper structure, clear headings, and enhanced readability.

Core Features & Use Cases

  • Automated Formatting: Applies frontmatter, titles, headings, bolding, lists, and code blocks to improve article layout.
  • Typography Enhancements: Includes CJK/English spacing and quote normalization for better typography.
  • Use Case: You have a draft article in plain text and want to quickly turn it into a well-formatted markdown document suitable for a blog post, complete with a title and organized sections.

Quick Start

Use the format-markdown skill to optimize the formatting of the attached file 'my-draft.md'.

Frequently Asked Questions about format-markdown

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

FAQPage Schema
How do I format plain text drafts into structured markdown with frontmatter and headings?

Formatting plain text into markdown involves automatically adding frontmatter, titles, and headings. The skill processes raw text and outputs a cleaned, structured markdown file with enhanced readability and organized sections.

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

Fixing CJK and English spacing in markdown is handled through typography enhancements. The skill normalizes quotes and adjusts spacing between Chinese, Japanese, or Korean characters and English text to produce cleanly formatted articles.

Can I use remark to add bolding, lists, and code blocks to existing markdown content?

Yes, you can use remark to add bolding, lists, and code blocks to existing markdown content. The skill leverages remark parsers to analyze your file and applies the appropriate markdown formatting structures to improve article layout.

Does remark-frontmatter support adding YAML metadata to plain text articles?

Yes, remark-frontmatter supports adding YAML metadata to plain text articles. The skill utilizes this dependency to automatically generate and prepend frontmatter, transforming unstructured drafts into standardized markdown documents.

How do I normalize quotes and typography in markdown for blog posts?

To normalize quotes and typography in markdown for blog posts, the skill applies automated typography fixes. It processes your document to standardize quote characters and ensure consistent text formatting throughout the final article.

Can remark-gfm handle formatting GitHub Flavored Markdown lists and code blocks?

Yes, remark-gfm can handle formatting GitHub Flavored Markdown lists and code blocks. The skill uses this dependency to parse and restructure GFM elements, ensuring your markdown lists and code blocks are correctly formatted.