markdown-formatter
以一致的样式、适当的标题层次结构、链接验证和代码块格式化格式化和检查Markdown文档。当使用Markdown文件、文档、README文件或技术写作时使用。检查常见问题,如断开的链接、不一致的格式和缺失的替代文本。在"format markdown"、"lint markdown"、"markdown style"、".md file"、"documentation formatting"时触发。
📖 中文导读:以一致的样式、适当的标题层次结构、链接验证和代码块格式化格式化和检查Markdown文档。当使用Markdown文件、文档、README文件或技术写作时使用。检查常见问题,如断开的链接、不一致的格式和缺失的替代文本。在"format markdown"、"lint markdown"、"markdown style"、".md file"、"documentation formatting"时触发。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: markdown-formatter description: Format and lint Markdown documents with consistent style, proper heading hierarchy, link validation, and code block formatting. Use when working with Markdown files, documentation, README files, or technical writing. Checks for common issues like broken links, inconsistent formatting, and missing alt text. Triggers on "format markdown", "lint markdown", "markdown style", ".md file", "documentation formatting".
Markdown Formatter
Purpose
Format and lint Markdown documents to ensure consistent style, proper structure, and best practices.
When to Use
- Formatting Markdown documentation
- Linting README files
- Checking markdown syntax
- Validating links in documentation
- Ensuring consistent style across docs
Core Instructions
- Read File: Load the Markdown file
- Check Syntax: Validate Markdown syntax
- Format: Apply consistent formatting
- Heading hierarchy (h1 -> h2 -> h3, no skips)
- List indentation (2 spaces)
- Code block language tags
- Link format consistency
- Validate: Check for common issues
- Broken internal links
- Missing alt text on images
- Empty links
- Output: Write formatted file or report issues
Formatting Rules
- Headings: ATX style (
#,##,###) - Lists: 2-space indentation for nested items
- Code blocks: Always specify language
- Links: Use reference style for repeated links
- Line length: 80-120 characters (guidance)
Example Pattern
# Main Title
## Section
### Subsection
Regular paragraph text.
- List item 1
- Nested item
- List item 2
```python
def example():
return "formatted"
## Dependencies
- Markdown parser (built-in)
- No external dependencies required
## Version
v1.0.0