markdown_expert

精通 Markdown 结构、AST 分析以及常见的格式化模式。

SKILL.md

--- frontmatter

name: markdown_expert
description: Expertise in Markdown structure, AST analysis, and common formatting patterns.

Markdown Expert Skill

Use this skill when analyzing, refactoring, or generating Markdown content.

Domain Knowledge

•Structure: Markdown consists of Blocks (Headers, Paragraphs, Lists) and Inline elements (Links, Emphasis, Code).
•AST: Common parsers like remark or markdown-it represent Markdown as a tree.
•
Rules:
- •Ensure headers follow a logical hierarchy (no skipping levels).
- •Use consistent list marker styles (- or *).
- •Validate link syntax and reference-style links.

Task Guidance

•
When asked to analyze a document, focus on:
- •Reading difficulty.
- •Structural consistency.
- •Potential for refactoring (e.g., long sections into sub-headers).
•When implementing "Clean Architecture" for Markdown, keep the Domain entities (e.g., MarkdownDocument, MarkdownSection) pure and agnostic of any specific parser if possible.