markdown-mermaid-writing

核心说明

• This skill teaches you — 、 enforces standard ，用于 — creating scientific documentation ，使用 markdown ，支持 embedded Mermaid diagrams as default 、 canonical format。
• core bet：relationship expressed as Mermaid diagram inside .md file is more valuable than any image. It is text，so it diffs cleanly in git. It requires no build step. It renders natively on GitHub，GitLab，Notion，VS Code，、 any markdown viewer. It uses fewer tokens than prose description of same relationship. 、 it can always be converted to polished image later — but text version remains source of truth。
• more you get your reports 、 files in.md in just regular text，which mermaid is as well as being simple 'script language'. This just helps ，支持 any downstream rendering 、 especially AI generated images (，使用 mermaid instead of just long form text to describe relationships < tokens). Additionally mermaid can render along ，支持 markdown ，用于 easy use almost anywhere by humans 或 AI." — Clayton Young (@borealBytes)，K-Dense Discord，2026-02-19。
• Creating any scientific document — reports，analyses，manuscripts，methods sections。
• Writing any documentation — READMEs，how-tos，decision records，project docs。