{"enrichment":{"faq":[{"a":"markdown-mermaid-writing embeds Mermaid diagrams directly in markdown using triple-backtick code blocks with the `mermaid` language identifier. Simply write your diagram syntax between the backticks\u2014no external tools needed. The diagrams render natively on GitHub, GitLab, and Notion without build steps, staying fully editable and version-control friendly.","q":"How do I embed diagrams in markdown files?"},{"a":"markdown-mermaid-writing includes 24 diagram type references covering flowcharts, sequence diagrams, class diagrams, state machines, Gantt charts, pie charts, entity-relationship diagrams, and more. Each type includes syntax examples and use-case guidance so you can select the right diagram for architecture, workflows, scientific processes, and technical reports.","q":"What diagram types does markdown-mermaid-writing support?"},{"a":"markdown-mermaid-writing provides 9 document templates and comprehensive style guides for consistent technical writing. Templates cover project documentation, scientific reports, and architecture specs. The guides enforce naming conventions, color schemes, and layout standards while keeping diagrams text-based, token-efficient, and smaller than prose descriptions.","q":"How to write markdown with mermaid diagrams for documentation?"},{"a":"markdown-mermaid-writing advocates text-based diagrams because they remain editable, diff-readable in git, and version-control friendly. Unlike PNG or JPG files, Mermaid source stays human-readable in commits, requires no external image editors, and renders consistently across platforms. They're also more accessible and serve as a single source of truth before any image conversion.","q":"Why use text-based diagrams instead of images?"},{"a":"Yes. markdown-mermaid-writing includes a comprehensive style guide and examples for consistent documentation standards. It covers Mermaid syntax best practices, markdown formatting conventions, accessibility requirements, and templates for reports, architecture diagrams, and workflows\u2014ensuring all team members produce uniform, professional technical documentation.","q":"Does markdown-mermaid-writing include a style guide?"},{"a":"markdown-mermaid-writing treats Mermaid source as the primary format and source of truth. While Mermaid diagrams can be converted to PNG or SVG using CLI tools or online renderers, the skill emphasizes keeping diagrams in text form for version control, editability, and accessibility. Conversion is optional and happens downstream of documentation.","q":"Can markdown-mermaid-writing diagrams be converted to images?"}],"shadow_tags":["text-based-visualization","documentation-standard","git-native-diagrams","accessibility-first","source-of-truth","diagram-templating","technical-writing","version-control-friendly","multi-format-export","structured-documentation"],"summary_rewrite":"This skill establishes markdown with embedded Mermaid diagrams as the source format for scientific documents, reports, and technical writing. It includes 24 diagram type references, 9 document templates, and comprehensive style guides to enforce consistent, version-control-friendly documentation. Text-based diagrams render natively on GitHub, GitLab, and Notion without build steps, remain editable, and stay smaller than prose descriptions."},"files":[{"bytes":14839,"path":"skills/markdown-mermaid-writing/SKILL.md","sha256":"801fabc81393c8467f13ed705940468b95c3e61fdad33cb7cca7550cc7c99900","url":"https://skillfed.io/files/K-Dense-AI/scientific-agent-skills/markdown-mermaid-writing/12f37912/SKILL.md"}],"id":"K-Dense-AI/scientific-agent-skills/markdown-mermaid-writing","links":{"html":"https://skillfed.io/K-Dense-AI/scientific-agent-skills/markdown-mermaid-writing","md":"https://skillfed.io/K-Dense-AI/scientific-agent-skills/markdown-mermaid-writing.md","repo":"https://github.com/K-Dense-AI/scientific-agent-skills"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":3173,"language":"Python","last_updated":"2026-07-28","license":"MIT","name":"markdown-mermaid-writing","publisher":"K-Dense-AI","stars":31940},"relations":{"similar":[{"id":"LeonChaoX/qinyan-academic-skills/markdown-mermaid-writing"},{"id":"beita6969/ScienceClaw/markdown-mermaid-writing"},{"id":"foryourhealth111-pixel/Vibe-Skills/markdown-mermaid-writing"},{"id":"openyak/openyak/charting"},{"id":"zLanqing/codex-claude-academic-skills/timesfm-forecasting"},{"id":"LeonChaoX/qinyan-academic-skills/timesfm-forecasting"},{"id":"K-Dense-AI/scientific-agent-skills/timesfm-forecasting"},{"id":"foryourhealth111-pixel/Vibe-Skills/timesfm-forecasting"},{"id":"wecode-ai/Wegent/mermaid-diagram"},{"id":"curiositech/some_claude_skills/mermaid-graph-writer"}]},"slug":{"owner":"K-Dense-AI","repo":"scientific-agent-skills","skill":"markdown-mermaid-writing"},"version":"12f37912"}