Markdown to Flowchart

Specific Problem

In technical documentation, describing processes, steps, or decision logic often relies on text. While Markdown provides structure, it has limitations for complex flows:
- Text descriptions can be lengthy, requiring readers to parse logic line by line
- Branching, looping, or parallel relationships are not intuitively presented
- Team collaboration may lead to inconsistent understanding of processes

How the Skill Works

This skill automates the analysis of Markdown documents and converts them into Mermaid flowcharts. The core process involves:
1. Reading the Document: Accepting the content of a user-provided .md file
2. Analyzing Structure: Identifying key elements in the document, such as:
- Section hierarchy (H1/H2/H3)
- Step sequences (numbered lists, step indicators)
- Conditional branches (if/else, whether)
- Dependencies (requires, needs before)
- Parallel processes (simultaneously)
3. Generating Code: Based on the analysis, automatically constructing Mermaid flowchart code:
- Using flowchart TD/LR/BT/RL to define the main flow direction
- Nodes described in Chinese for readability
- Conditional decisions using diamond nodes for clear branching
4. Outputting Results: Embedding the Mermaid code into a new .md file for immediate use

Applicable Boundaries and Considerations

The skill is suitable for various document types but has limitations to note:
- Input Format: Only standard Markdown documents are supported; unstructured text may yield poor results
- Node Length: It's recommended to keep node descriptions under 20 characters to maintain chart clarity
- Logical Completeness: Effectiveness depends on the document's structured level; implicit logic may not be automatically identified
- Output Dependency: Generated flowcharts require tools that support Mermaid rendering, such as GitHub or local Markdown viewers

By visualizing text-based processes, this skill helps developers quickly grasp document logic and is applicable to deployment documents, API documentation, operational manuals, READMEs, tutorials, architectural designs, and project management scenarios.