{"id":52048269,"url":"https://github.com/d2lang/d2","last_synced_at":"2026-08-02T22:00:39.606Z","repository":{"id":63389806,"uuid":"533087958","full_name":"d2lang/d2","owner":"d2lang","description":"D2 is a modern diagram scripting language that turns text to diagrams.","archived":false,"fork":false,"pushed_at":"2026-08-02T03:55:45.000Z","size":224961,"stargazers_count":24821,"open_issues_count":540,"forks_count":712,"subscribers_count":78,"default_branch":"master","last_synced_at":"2026-08-02T05:10:09.086Z","etag":null,"topics":["developer-tools","diagramming","diagrams","go","golang","software-architecture","text-to-diagram"],"latest_commit_sha":null,"homepage":"https://d2lang.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/d2lang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2022-09-05T23:12:27.000Z","updated_at":"2026-08-02T03:56:02.000Z","dependencies_parsed_at":"2022-11-18T02:47:04.170Z","dependency_job_id":"10cd6396-4e9b-473d-8a17-50bd1328e0c0","html_url":"https://github.com/d2lang/d2","commit_stats":{"total_commits":3116,"total_committers":55,"mean_commits":"56.654545454545456","dds":0.6225930680359435,"last_synced_commit":"94d5ab5d2ec4be33e4227bc767e2e87068ce00ef"},"previous_names":["d2lang/d2"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/d2lang/d2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d2lang%2Fd2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d2lang%2Fd2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d2lang%2Fd2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d2lang%2Fd2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/d2lang","download_url":"https://codeload.github.com/d2lang/d2/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d2lang%2Fd2/sbom","scorecard":{"id":567889,"data":{"date":"2025-08-11","repo":{"name":"github.com/terrastruct/d2","commit":"c717f3a22c756a972329edce800bdbfa7fa8dccf"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 0/3 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 16 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Warn: no topLevel permission defined: .github/workflows/daily.yml:1","Warn: no topLevel permission defined: .github/workflows/project.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: d2js/js/d2.wasm:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Info: FSF or OSI recognized license: Mozilla Public License 2.0: LICENSE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.7.0 not signed: https://api.github.com/repos/terrastruct/d2/releases/216090500","Warn: release artifact v0.6.9 not signed: https://api.github.com/repos/terrastruct/d2/releases/198493484","Warn: release artifact v0.6.8 not signed: https://api.github.com/repos/terrastruct/d2/releases/184244337","Warn: release artifact v0.6.7 not signed: https://api.github.com/repos/terrastruct/d2/releases/177442028","Warn: release artifact v0.6.6 not signed: https://api.github.com/repos/terrastruct/d2/releases/168360260","Warn: release artifact v0.7.0 does not have provenance: https://api.github.com/repos/terrastruct/d2/releases/216090500","Warn: release artifact v0.6.9 does not have provenance: https://api.github.com/repos/terrastruct/d2/releases/198493484","Warn: release artifact v0.6.8 does not have provenance: https://api.github.com/repos/terrastruct/d2/releases/184244337","Warn: release artifact v0.6.7 does not have provenance: https://api.github.com/repos/terrastruct/d2/releases/177442028","Warn: release artifact v0.6.6 does not have provenance: https://api.github.com/repos/terrastruct/d2/releases/168360260"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/daily.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/daily.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/daily.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/daily.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/daily.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/daily.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/daily.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/daily.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/daily.yml:63: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/daily.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/project.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/terrastruct/d2/project.yml/master?enable=pin","Warn: containerImage not pinned by hash: ci/release/docker/Dockerfile:2: pin your Docker image by updating ubuntu:latest to ubuntu:latest@sha256:7c06e91f61fa88c08cc74f7e1b7c69ae24910d745357e0dfe1d2c0322aaf20f9","Warn: containerImage not pinned by hash: ci/release/linux/Dockerfile:1: pin your Docker image by updating debian:10 to debian:10@sha256:58ce6f1271ae1c8a2006ff7d3e54e9874d839f573d8009c20154ad0f2fb0a225","Warn: downloadThenRun not pinned by hash: ci/release/docker/Dockerfile:8-9","Warn: downloadThenRun not pinned by hash: d2js/js/make.sh:15","Info:   0 out of  11 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned","Info:   0 out of   2 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":7,"reason":"3 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2025-3485 / GHSA-c6gw-w398-hv78","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}}]},"last_synced_at":"2025-08-20T15:28:32.927Z","repository_id":63389806,"created_at":"2025-08-20T15:28:32.927Z","updated_at":"2025-08-20T15:28:32.927Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36210049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-08-02T02:00:06.915Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["developer-tools","diagramming","diagrams","go","golang","software-architecture","text-to-diagram"],"created_at":"2026-08-02T10:00:23.689Z","updated_at":"2026-08-02T22:00:39.600Z","avatar_url":"https://github.com/d2lang.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/banner.png\" alt=\"D2\" /\u003e\n  \u003ch2\u003e\n    A modern diagram scripting language that turns text to diagrams.\n  \u003c/h2\u003e\n\n[Docs](https://d2lang.com) | [Cheat sheet](./docs/assets/cheat_sheet.pdf) | [Comparisons](https://text-to-diagram.com) | [Playground](https://play.d2lang.com)\n\n[![ci](https://github.com/d2lang/d2/actions/workflows/ci.yml/badge.svg)](https://github.com/d2lang/d2/actions/workflows/ci.yml)\n[![daily](https://github.com/d2lang/d2/actions/workflows/daily.yml/badge.svg)](https://github.com/d2lang/d2/actions/workflows/daily.yml)\n[![release](https://img.shields.io/github/v/release/d2lang/d2)](https://github.com/d2lang/d2/releases)\n[![changelog](https://img.shields.io/badge/changelog-read-blue)](./CHANGELOG.md)\n[![npm version](https://img.shields.io/npm/v/@terrastruct/d2)](https://www.npmjs.com/package/@terrastruct/d2)\n[![discord](https://img.shields.io/discord/1039184639652265985?label=discord)](https://discord.gg/NF6X8K4eDq)\n[![twitter](https://img.shields.io/twitter/follow/terrastruct?style=social)](https://twitter.com/terrastruct)\n[![license](https://img.shields.io/github/license/d2lang/d2?color=9cf)](./LICENSE.txt)\n\n\u003ca href=\"https://play.d2lang.com\"\u003e\n\u003cimg src=\"./docs/assets/playground_button.png\" alt=\"D2 Playground button\" width=\"200\" /\u003e\n\u003c/a\u003e\n\nhttps://user-images.githubusercontent.com/3120367/206125010-bd1fea8e-248a-43e7-8f85-0bbfca0c6e2a.mp4\n\n\u003c/div\u003e\n\n# Table of Contents\n\n\u003c!-- toc --\u003e\n- [What does D2 look like?](#what-does-d2-look-like)\n- [Quickstart](#quickstart)\n- [Install](#install)\n- [D2 as a library](#d2-as-a-library)\n- [Themes](#themes)\n- [Fonts](#fonts)\n- [Export file types](#export-file-types)\n- [Language tooling](#language-tooling)\n- [Plugins](#plugins)\n- [Comparison](#comparison)\n- [Contributing](#contributing)\n- [License](#license)\n- [Related](#related)\n  - [Official plugins](#official-plugins)\n  - [Community plugins](#community-plugins)\n  - [Misc](#misc)\n- [FAQ](#faq)\n- [Notable open-source projects documenting with D2](#notable-open-source-projects-documenting-with-d2)\n\n## What does D2 look like?\n\n```d2\nvars: {\n  d2-config: {\n    layout-engine: elk\n    # Terminal theme code\n    theme-id: 300\n  }\n}\nnetwork: {\n  cell tower: {\n    satellites: {\n      shape: stored_data\n      style.multiple: true\n    }\n\n    transmitter\n\n    satellites -\u003e transmitter: send\n    satellites -\u003e transmitter: send\n    satellites -\u003e transmitter: send\n  }\n\n  online portal: {\n    ui: {shape: hexagon}\n  }\n\n  data processor: {\n    storage: {\n      shape: cylinder\n      style.multiple: true\n    }\n  }\n\n  cell tower.transmitter -\u003e data processor.storage: phone logs\n}\n\nuser: {\n  shape: person\n  width: 130\n}\n\nuser -\u003e network.cell tower: make call\nuser -\u003e network.online portal.ui: access {\n  style.stroke-dash: 3\n}\n\napi server -\u003e network.online portal.ui: display\napi server -\u003e logs: persist\nlogs: {shape: page; style.multiple: true}\n\nnetwork.data processor -\u003e api server\n```\n\n\u003cp align=\"center\"\u003e\n    \u003cimg width=\"400px\" src=\"./docs/assets/example.svg\" alt=\"D2 render example\" /\u003e\n\u003c/p\u003e\n\n\u003e Open in [playground](https://play.d2lang.com/?script=rVLLTsQwDLznKyJxbrWwtyLxFdyR1Zg2ahpHibvLCvXfcdqGfSHthVv8yIxn7APE1OhvpbV5qVryn7ZbQ60dnGjiCn1nPTYa3bCkn_Q7xtF6cJp7HFG3ZHCpLGFlTaP3u51kZjUrj3ykOKyYLTr5REeMhSMBS84yppKRXA9B-BJTRPNhgKEU-OSwHifHNjjp4DitxLNa-SP4NFpmjOoGXVdvl2VBR2_-sWeZgLwTp3SgyOCKnsnKa5PU4xd05OfyIWvTIVKLKdHZExEOHd4Z0p4E3oi2h25s8Ge764uZs4Rr4vqXMfQkAhx1SVanplQWtU0QMCbyEh-t4b7Rz_td6cuo267ryzWPMMiFgHN3XVdu1dkmaPM8K-EiLnGkASsDScj2mQqCFcvj4RGUsSnI_d70Z2GrCptYrVHZTRADXv80VWgL0bVvGfJMoH4A)\n\n\u003e For more examples, see [./docs/examples](./docs/examples).\n\n## Quickstart\n\nThe most convenient way to use D2 is to just run it as a CLI executable to\nproduce SVGs from `.d2` files.\n\n```sh\n# First, install D2\ncurl -fsSL https://d2lang.com/install.sh | sh -s --\n\necho 'x -\u003e y -\u003e z' \u003e in.d2\nd2 --watch in.d2 out.svg\n```\n\nA browser window will open with `out.svg` and live-reload on changes to `in.d2`.\n\n## Install\n\nThe easiest way to install is with our install script:\n\n```sh\ncurl -fsSL https://d2lang.com/install.sh | sh -s --\n```\n\nYou can run the install script with `--dry-run` to see the commands that will be used\nto install without executing them.\n\nOr if you have Go installed you can install from source though you won't get the manpage:\n\n```sh\ngo install oss.terrastruct.com/d2@latest\n```\n\nYou can also install a release from source which will include manpages.\nSee [./docs/INSTALL.md#source-release](./docs/INSTALL.md#source-release).\n\nTo uninstall with the install script:\n\n```sh\ncurl -fsSL https://d2lang.com/install.sh | sh -s -- --uninstall\n```\n\nFor detailed installation docs, see [./docs/INSTALL.md](./docs/INSTALL.md).\nWe demonstrate alternative methods and examples for each OS.\n\nAs well, the functioning of the install script is described in detail to alleviate any\nconcern of its use. We recommend using your OS's package manager directly instead for\nimproved security but the install script is by no means insecure.\n\n## D2 as a library\n\nIn addition to being a runnable CLI tool, D2 can also be used to produce diagrams from\nGo programs.\n\nFor examples, see [./docs/examples/lib](./docs/examples/lib). This [blog\npost](https://terrastruct.com/blog/post/generate-diagrams-programmatically/) also demos a\ncomplete, runnable example of using D2 as a library for a real-world use case.\n\n## Themes\n\nD2 includes a variety of official themes to style your diagrams beautifully right out of\nthe box. See [./d2themes](./d2themes) to browse the available themes and make or\ncontribute your own creation.\n\n## Fonts\n\nD2 ships with \"Source Sans Pro\" as the font in renders. If you wish to use a different\none, please see [./d2renderers/d2fonts](./d2renderers/d2fonts).\n\n## Export file types\n\nD2 currently supports SVG, PNG and PDF exports. More coming soon.\n\n## Language tooling\n\nD2 is designed with language tooling in mind. D2's parser can parse multiple errors from a\nbroken program, has an autoformatter, syntax highlighting, and we have plans for LSP's and\nmore. Good language tooling is necessary for creating and maintaining large diagrams.\n\nThe extensions for VSCode and Vim can be found in the [Related](#related) section.\n\n## Plugins\n\nD2 is designed to be extensible and composable. The plugin system allows you to\nchange out layout engines and customize the rendering pipeline. Plugins can either be\nbundled with the build or separately installed as a standalone binary.\n\n**Layout engines**:\n\n- [dagre](https://github.com/dagrejs/dagre) (default, bundled): A fast, directed graph\n  layout engine that produces layered/hierarchical layouts. Based on Graphviz's DOT\n  algorithm.\n- [ELK](https://github.com/kieler/elkjs) (bundled): A directed graph layout engine\n  particularly suited for node-link diagrams with an inherent direction and ports.\n- [TALA](https://github.com/terrastruct/TALA) (binary): Novel layout engine designed\n  specifically for software architecture diagrams. Requires separate install, visit the\n  Github page for more.\n\nD2 intends to integrate with a variety of layout engines, e.g. `dot`, as well as\nsingle-purpose layout types like sequence diagrams. You can choose whichever layout engine\nyou like and works best for the diagram you're making.\n\n## Comparison\n\nFor a comparison against other popular text-to-diagram tools, see\n[https://text-to-diagram.com](https://text-to-diagram.com).\n\n## Contributing\n\nContributions are welcome! See [./docs/CONTRIBUTING.md](./docs/CONTRIBUTING.md).\n\n## License\n\nOpen sourced under the Mozilla Public License 2.0. See [./LICENSE.txt](./LICENSE.txt).\n\n## Related\n\nWe are constantly working on new plugins, integrations, extensions. Contributions are\nwelcome in any official or community plugins. If you have somewhere in your workflow that\nyou want to use D2, feel free to open a discussion. We have limited bandwidth and usually\nchoose the most high-demand ones to work on. If you make something cool with D2 yourself,\nlet us know and we'll be happy to include it here!\n\n### Official plugins\n\n- **VSCode extension**: [https://github.com/d2lang/d2-vscode](https://github.com/d2lang/d2-vscode)\n- **Vim extension**: [https://github.com/d2lang/d2-vim](https://github.com/d2lang/d2-vim)\n- **Obsidian plugin**: [https://github.com/d2lang/d2-obsidian](https://github.com/d2lang/d2-obsidian)\n- **Slack app**: [https://d2lang.com/tour/slack](https://d2lang.com/tour/slack)\n- **Discord plugin**: [https://d2lang.com/tour/discord](https://d2lang.com/tour/discord)\n\n### Community plugins\n\n- **Tree-sitter grammar**: [https://github.com/ravsii/tree-sitter-d2](https://github.com/ravsii/tree-sitter-d2)\n- **Emacs major mode**: [https://github.com/andorsk/d2-mode](https://github.com/andorsk/d2-mode)\n- **Goldmark extension**: [https://github.com/FurqanSoftware/goldmark-d2](https://github.com/FurqanSoftware/goldmark-d2)\n- **Telegram bot**: [https://github.com/meinside/telegram-d2-bot](https://github.com/meinside/telegram-d2-bot)\n- **Postgres importer**: [https://github.com/zekenie/d2-erd-from-postgres](https://github.com/zekenie/d2-erd-from-postgres)\n- **Structurizr to D2 exporter**: [https://github.com/goto1134/structurizr-d2-exporter](https://github.com/goto1134/structurizr-d2-exporter)\n- **MdBook preprocessor**: [https://github.com/danieleades/mdbook-d2](https://github.com/danieleades/mdbook-d2)\n- **ROS2 D2 Exporter**: [https://github.com/Greenroom-Robotics/ros-d2](https://github.com/Greenroom-Robotics/ros-d2)\n- **D2 org-mode support**: [https://github.com/xcapaldi/ob-d2](https://github.com/xcapaldi/ob-d2)\n- **Python D2 diagram builder**: [https://github.com/MrBlenny/py-d2](https://github.com/MrBlenny/py-d2)\n- **Clojure D2 transpiler**: [https://github.com/judepayne/dictim](https://github.com/judepayne/dictim)\n- **JavaScript D2 diagram builder**: [https://github.com/Kreshnik/d2lang-js](https://github.com/Kreshnik/d2lang-js)\n- **C# \u0026 dotnet SDK**: [https://github.com/Stephanvs/d2lang-cs](https://github.com/Stephanvs/d2lang-cs)\n- **Maven plugin**: [https://github.com/andrinmeier/unofficial-d2lang-maven-plugin](https://github.com/andrinmeier/unofficial-d2lang-maven-plugin)\n- **Confluence plugin**: [https://github.com/andrinmeier/unofficial-d2lang-confluence-plugin](https://github.com/andrinmeier/unofficial-d2lang-confluence-plugin)\n- **CIL (C#, Visual Basic, F#, C++ CLR) to D2**: [https://github.com/HugoVG/AppDiagram](https://github.com/HugoVG/AppDiagram)\n- **D2 Snippets (for text editors)**: [https://github.com/Paracelsus-Rose/D2-Language-Code-Snippets](https://github.com/Paracelsus-Rose/D2-Language-Code-Snippets)\n- **Mongo to D2**: [https://github.com/novuhq/mongo-to-D2](https://github.com/novuhq/mongo-to-D2)\n- **Pandoc filter (TypeScript)**: [https://github.com/ram02z/d2-filter](https://github.com/ram02z/d2-filter)\n- **Pandoc filter (Python)**: [https://github.com/fliiiix/pandoc-d2-filter](https://github.com/fliiiix/pandoc-d2-filter)\n- **Logseq-D2**: [https://github.com/b-yp/logseq-d2](https://github.com/b-yp/logseq-d2)\n- **ent2d2**: [https://github.com/tmc/ent2d2](https://github.com/tmc/ent2d2)\n- **MkDocs Plugin**: [https://github.com/landmaj/mkdocs-d2-plugin](https://github.com/landmaj/mkdocs-d2-plugin)\n- **Remark Plugin**: [https://github.com/mech-a/remark-d2](https://github.com/mech-a/remark-d2)\n- **VitePress Plugin**: [https://github.com/BadgerHobbs/vitepress-plugin-d2](https://github.com/BadgerHobbs/vitepress-plugin-d2)\n- **Zed extension**: [https://github.com/gabeidx/zed-d2](https://github.com/gabeidx/zed-d2)\n- **Hexo blog extension**: [https://github.com/leverimmy/hexo-d2](https://github.com/leverimmy/hexo-d2)\n- **Rehype Plugin**: [https://github.com/stereobooster/beoe/tree/main/packages/rehype-d2](https://github.com/stereobooster/beoe/tree/main/packages/rehype-d2)\n- **AsyncAPI to D2**: [https://github.com/holydocs/messageflow](https://github.com/holydocs/messageflow)\n- **Database Schemas to D2**: [https://github.com/holydocs/dberd](https://github.com/holydocs/dberd)\n\n### Misc\n\n- **Comparison site**: [https://github.com/terrastruct/text-to-diagram-site](https://github.com/terrastruct/text-to-diagram-site)\n- **Playground**: [https://github.com/d2lang/d2-playground](https://github.com/d2lang/d2-playground)\n- **Language docs**: [https://github.com/d2lang/d2-docs](https://github.com/d2lang/d2-docs)\n- **Hosted icons**: [https://icons.terrastruct.com](https://icons.terrastruct.com)\n\n## FAQ\n\n- Does D2 collect telemetry?\n  - No, D2 does not use an internet connection after installation, except to check for\n    version updates from Github periodically.\n- Does D2 need a browser to run?\n  - No, D2 can run entirely server-side.\n- What's coming in the next release?\n  - See [./ci/release/changelogs/next.md](./ci/release/changelogs/next.md).\n- I have a question or need help.\n  - The best way to get help is to ask on [D2 Discord](https://discord.gg/NF6X8K4eDq)\n- I have a feature request, proposal, or bug report.\n  - Please open up a Github Issue.\n- I have a private inquiry.\n  - Please reach out at [hi@d2lang.com](hi@d2lang.com).\n\n## Notable open-source projects documenting with D2\n\nDo you have or see an open-source project with `.d2` files? Please submit a PR adding to\nthis selected list of featured projects using D2.\n\n- [ElasticSearch](https://github.com/elastic/beats/blob/main/libbeat/publisher/queue/proxy/diagrams/broker.d2)\n- [Sourcegraph](https://handbook.sourcegraph.com/departments/engineering/managed-services/telemetry-gateway/#dev-architecture-diagram)\n- [Temporal](https://github.com/temporalio/temporal/blob/0be2681c994470c7c61ea88e4fcef89bb4024e58/docs/_assets/matching-context.d2)\n- [Tauri](https://v2.tauri.app/concept/inter-process-communication/)\n    - Rust GUI framework (78.5k stars)\n- [Intellij](https://github.com/JetBrains/intellij-community/blob/45bcfc17a3f3e0d8548bc69e922d4ca97ac21b2b/platform/settings/docs/topics/overview.md)\n- [Coder](https://coder.com/blog/managing-templates-in-coder)\n- [UC\n  Berkeley](https://github.com/ucb-bar/hammer/blob/2b5c04d7b7d9ee3c73575efcd7ee0698bd5bfa88/doc/Hammer-Use/hier.d2)\n- [Coronacheck](https://github.com/minvws/nl-covid19-coronacheck-app-ios/blob/e1567e9d1633b3273c537a105bff0e7d3a57ecfe/Diagrams/client-side-datamodel.d2)\n  - Official app of the Netherlands for coronavirus entry passes.\n- [Block\n  Protocol](https://github.com/blockprotocol/blockprotocol/blob/db4cf8d422b881e52113aa52467d53115270e2b3/libs/%40blockprotocol/type-system/crate/assets/overview.d2)\n  - The Block Protocol is an open standard for building and using data-driven blocks (1.2k\n    stars).\n- [Dagger](https://github.com/dagger/dagger/tree/main/cmd/dagger-graph)\n  - A programmable CI/CD engine that runs your pipelines in containers (8k stars).\n- [Ivy\n  Wallet](https://github.com/Ivy-Apps/ivy-wallet/blob/8062624bfa65175ec143cdc4038de27a84d38b57/assets/calc_algo.d2)\n  - Open-source money manager app for Android (1.1k stars).\n- [LocalStack](https://docs.localstack.cloud/references/network-troubleshooting/)\n  - Cloud service emulator (46k stars)\n- [Queue Library](https://github.com/golang-queue/queue/tree/master/images)\n  - Queue is a Golang library for spawning and managing a Goroutine pool\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd2lang%2Fd2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd2lang%2Fd2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd2lang%2Fd2/lists"}