/ Home

N-As-Code

Diagram-as-Code

Mermaid

• Website: https://mermaid.js.org/
• Language: Markdown-like syntax
• Supports: Flowchart, Sequence, Class, ER, Gantt, State diagrams
• Works in: GitHub, GitLab, Obsidian, Notion
• Best for: Lightweight architecture + workflow diagrams

PlantUML

• Website: https://plantuml.com/
• Language: PlantUML DSL
• Supports: Full UML (Sequence, Component, Deployment, Activity, etc.)
• Output: PNG, SVG
• Best for: Enterprise-grade UML diagrams

Graphviz

• Website: https://graphviz.org/
• Language: DOT
• Supports: Directed/undirected graphs
• Best for: Dependency graphs, compiler visualizations

Structurizr

• Website: https://structurizr.com/
• Model: C4 Architecture model
• Supports: System Context, Container, Component diagrams
• Best for: Clean architecture documentation

---

Infrastructure-as-Code (IaC)

Terraform

• Website: https://www.terraform.io/
• Language: HCL (Declarative)
• Multi-cloud: AWS, GCP, Azure
• Best for: Scalable cloud provisioning

AWS CloudFormation

• Website: https://aws.amazon.com/cloudformation/
• Language: YAML / JSON
• Cloud: AWS-native
• Best for: AWS-only environments

Pulumi

• Website: https://www.pulumi.com/
• Language: Python, TypeScript, Go, C#
• Approach: Infrastructure using real programming languages
• Best for: Code-first teams

Ansible

• Website: https://www.ansible.com/
• Language: YAML playbooks
• Focus: Configuration management
• Best for: Server automation

Kubernetes

• Website: https://kubernetes.io/
• Language: YAML manifests
• Focus: Container orchestration
• Best for: Declarative container infrastructure

---

Documentation-as-Code

MkDocs

• Website: https://www.mkdocs.org/
• Language: Markdown
• Theme: Material (popular)
• Best for: Technical product documentation

Sphinx

• Website: https://www.sphinx-doc.org/
• Language: reStructuredText / Markdown
• Feature: Auto-generate API docs
• Best for: Python SDK documentation

Docusaurus

• Website: https://docusaurus.io/
• Language: Markdown + React
• Feature: Versioned docs
• Best for: Developer portals

GitBook

• Website: https://www.gitbook.com/
• Language: Markdown
• Feature: Hosted documentation platform
• Best for: SaaS documentation