markdown-formatter

Format Markdown files to fix structural inconsistencies and improve readability.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/test141515111/blog-writing-suite --skill markdown-formatter-test141515111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-formatter
Source: https://github.com/test141515111/blog-writing-suite/tree/main/skills/markdown-formatter
Command: npx skills add https://github.com/test141515111/blog-writing-suite --skill markdown-formatter-test141515111

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdownの整形作業は繰り返し行われ、見出しの不統一、コードブロックの言語指定欠如、表の揃い方の乱れなどが生じます。このSkillは、読みやすさと一貫性を確保するべく、Markdownファイルを自動的に整形します。

Core Features & Use Cases

  • Heading normalization: 見出しの階層を正しくそろえ、H1は1つだけに保ちます。
  • Code block formatting: コードブロックに言語を付与し、インデントを整えます。
  • Link and table polishing: リンクを検証・整形、表を揃えます。
  • Use Case: チームのドキュメントが混在したリポジトリを1つのスタイルに統一して、読みやすさを向上させます。

Quick Start

Provide a Markdown file path and run the formatter to normalize structure, code blocks, and links.

Frequently Asked Questions about markdown-formatter

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

FAQPage Schema
How do I fix inconsistent markdown formatting across my documentation files?

Markdown formatting normalizes structural inconsistencies by standardizing headings, code block language tags, table alignment, and link validation across all files. Run the formatter on your documentation directory to automatically apply consistent style to READMEs, guides, and tutorials.

Can I enforce consistent heading hierarchy and code block language tags in markdown?

Yes. The formatter enforces proper heading order with a single H1, applies language tags to code blocks, corrects indentation, and aligns tables. It validates links and ensures end-of-file newlines, making your markdown structure uniform across repositories.

What markdown elements can be formatted for consistency?

The formatter handles headings, code blocks with language specification, lists, tables with proper alignment, links with validation, and image captions. It also corrects indentation and enforces end-of-file newline conventions across diverse repository structures.

How do I standardize markdown style across a team's mixed documentation repository?

Provide markdown file paths to the formatter, which normalizes structure, code blocks, and links automatically. This unifies disparate documentation into a single consistent style, improving readability and maintainability for the entire team.

Can markdown formatting handle large documentation projects with multiple file types?

Yes. The formatter applies to documentation, READMEs, guides, and tutorials in diverse repositories. It processes multiple markdown files using Read/Edit/Write tools to fix structural inconsistencies while maintaining your content's integrity.