{"full_name":"mermaid-js/mermaid","owner":"mermaid-js","name":"mermaid","url":"https://github.com/mermaid-js/mermaid","description":"Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown","homepage":"https://mermaid.ai/open-source/","topics":[],"language":"TypeScript","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/57169982?v=4","created_at":"2014-11-01T23:52:32Z","pushed_at":"2026-11-10T09:20:00Z","metrics":{"stars":91060,"forks":9473,"watchers":637,"issues":3951,"prs":4237,"releases":228,"issues_open":null,"issues_closed":null,"prs_open":null,"prs_closed":null,"prs_merged":null,"discussions":451},"growth":{"day":{"stars":12,"forks":1,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10"],"stars":[91048,91060],"forks":[9472,9473],"watchers":[637,637],"issues_open":[null,null],"prs_open":[null,null]},"boards":{"total":182},"same_owner":[],"issues":[{"number":523,"title":"Styling components of the sequence diagram","comments":103,"created_at":"2017-04-20T22:21:39Z"},{"number":1462,"title":"Component Diagram","comments":79,"created_at":"2020-06-10T20:00:09Z"},{"number":2623,"title":"BPMN support","comments":57,"created_at":"2022-01-13T09:09:12Z"},{"number":1227,"title":"New diagram type: network topology","comments":57,"created_at":"2020-01-28T13:50:26Z"},{"number":2977,"title":"Move the subgraph label to the bottom left corner","comments":51,"created_at":"2022-04-27T16:25:34Z"},{"number":821,"title":"Note in flowchart diagram","comments":51,"created_at":"2019-04-11T13:50:15Z"},{"number":3208,"title":"Backwards arrow direction","comments":46,"created_at":"2022-07-06T13:37:41Z"},{"number":3989,"title":"New Diagram Type: Tree Chart","comments":45,"created_at":"2023-01-13T18:51:46Z"}],"discussions":[{"number":8685,"title":"Mermaid v13: going on a diet, and we want your input","comments":3,"category":"Ideas","created_at":"2026-11-04T11:51:00Z"},{"number":8648,"title":"Offer: priced triage packet for the 10 oldest triage bugs ($50)","comments":0,"category":"General","created_at":"2026-10-31T13:24:28Z"},{"number":8569,"title":"flowchart: left directed arrow ⟵ (edges) is missing; is it possible to include, Thanks.","comments":0,"category":"Ideas","created_at":"2026-10-26T16:40:39Z"},{"number":8468,"title":"Mermaid Timeline Editor: In-browser editor with live preview and SVG export","comments":0,"category":"Show and tell","created_at":"2026-10-18T13:47:19Z"},{"number":8418,"title":"SeqShow: step-by-step Mermaid sequence presentations with offline HTML export","comments":1,"category":"Show and tell","created_at":"2026-10-10T23:33:01Z"},{"number":8346,"title":"Is anyone familiar with this type of diagram?","comments":0,"category":"General","created_at":"2026-09-29T08:57:32Z"},{"number":8325,"title":"By default embedded fonts?","comments":1,"category":"Q&A","created_at":"2026-09-27T07:35:21Z"},{"number":8317,"title":"Significant layout change between 11.12.0 and 12.0.0","comments":2,"category":"Q&A","created_at":"2026-09-25T11:42:58Z"}],"latest_release":{"name":"@mermaid-js/tiny@12.3.0","tag":"@mermaid-js/tiny@12.3.0","published_at":"2026-11-03T13:11:22Z","body":"### Minor Changes\n\n-   [#8164](https://github.com/mermaid-js/mermaid/pull/8164) [`592d0e4`](https://github.com/mermaid-js/mermaid/commit/592d0e407d557b501d9f273ed18c7c62b1b9f48b) Thanks [@filipsajdak](https://github.com/filipsajdak)! - feat: add the open-arrow and hollow-circle edge markers, so a notation can tell two kinds of flow apart by whether the head is filled\n\n-   [#8165](https://github.com/mermaid-js/mermaid/pull/8165) [`5c8aa5d`](https://github.com/mermaid-js/mermaid/commit/5c8aa5d834b7090258259eaf8b827cbefd6ff40f) Thanks [@filipsajdak](https://github.com/filipsajdak)! - feat: add the BPMN element shapes - events, gateways, activities, data objects, data stores and text annotations - each reporting where a line meets what is drawn\n\n-   [#8470](https://github.com/mermaid-js/mermaid/pull/8470) [`692d22a`](https://github.com/mermaid-js/mermaid/commit/692d22a3ec9cf235cecf17013160f14dafb42999) Thanks [@openmindednewby](https://github.com/openmindednewby)! - feat: flowchart edges accept a `step` number (`e1@{ step: 1 }`); a dot travels the edges in step order and loops, hidden under `prefers-reduced-motion`\n\n-   [#8478](https://github.com/mermaid-js/mermaid/pull/8478) [`56aa105`](https://github.com/mermaid-js/mermaid/commit/56aa10536075a320c084087478c468553b923e6e) Thanks [@openmindednewby](https://github.com/openmindednewby)! - feat: add `flowchart.stepDuration` to set how many seconds each step of the flowchart step animation lasts\n\n-   [#8479](https://github.com/mermaid-js/mermaid/pull/8479) [`800f7ef`](https://github.com/mermaid-js/mermaid/commit/800f7efb1c7e80cf56478507808c744a1d07e1c1) Thanks [@openmindednewby](https://github.com/openmindednewby)! - feat: highlight the flowchart edge whose step is playing, in sync with the step animation dot\n\n-   [#8480](https://github.com/mermaid-js/mermaid/pull/8480) [`50d6294`](https://github.com/mermaid-js/mermaid/commit/50d6294dab27123d7ecc1301c2c861bfe7ef4dce) Thanks [@openmindednewby](https://github.com/openmindednewby)! - feat: add `flowchart.stepNumbers` to show each step edge's number in a badge\n\n### Patch Changes\n\n-   [#8443](https://github.com/mermaid-js/mermaid/pull/8443) [`2ff8286`](https://github.com/mermaid-js/mermaid/commit/2ff8286f9aa82b89aefe26c575c49a575fa518c1) Thanks [@knsv-bot](https://github.com/knsv-bot)! - fix: agentflow renders the `a[/…/]` short form as an input instead of falling back to a task with a SHAPE_UNSUPPORTED warning\n\n-   [#8661](https://github.com/mermaid-js/mermaid/pull/8661) [`b200b27`](https://github.com/mermaid-js/mermaid/commit/b200b270f5e51d9199c5263dc402f4a6fe4fa33a) Thanks [@pbrolin47](https://github.com/pbrolin47)! - fix: Bump DOMPurify to 3.4.17 to address GHSA-55q2-fjhq-7xh7 and GHSA-6688-9rhm-gjv2\n\n-   [#8633](https://github.com/mermaid-js/mermaid/pull/8633) [`686f350`](https://github.com/mermaid-js/mermaid/commit/686f350e8c7627dfcc6b0035f237f76bca1152b2) Thanks [@sidharthv96](https://github.com/sidharthv96)! - chore: Remove the `uuid` dependency and the unused legacy ER diagram renderer\n\n-   [#8661](https://github.com/mermaid-js/mermaid/pull/8661) [`7eec083`](https://github.com/mermaid-js/mermaid/commit/7eec083adcaba707257795feb937f2274c990713) Thanks [@pbrolin47](https://github.com/pbrolin47)! - fix: Stop an edge from a node inside a subgraph from crossing an edge from the subgraph itself to the same node with ELK 0.10+ (e.g. `outer --> a` with `da --> a`, or `three --> two` with `two --> c2`)\n\n-   [#8532](https://github.com/mermaid-js/mermaid/pull/8532) [`42d3760`](https://github.com/mermaid-js/mermaid/commit/42d37602aed5ddbfb2674b78e08336fa5f3fb548) Thanks [@Devehab](https://github.com/Devehab)! - fix: upgrade bundled elkjs from 0.9.3 to 0.12.0, which is licensed `EPL-2.0 OR GPL-3.0-or-later`, so GPL-3.0 projects can ship mermaid with ELK\n\n-   [#8162](https://github.com/mermaid-js/mermaid/pull/8162) [`d5ca27a`](https://github.com/mermaid-js/mermaid/commit/d5ca27a636a2a5b65768c8ef3f847601dac055a9) Thanks [@filipsajdak](https://gi"},"readme":true,"readme_zh":true,"news":[{"title":"Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text","url":"https://github.com/mermaid-js/mermaid","hn":"https://news.ycombinator.com/item?id=44049619","source":"Hacker News","lang":"en","date":"2025-05-21","points":255,"comments":107},{"title":"Mermaid: Create complex diagrams using Markdown-inspired","url":"https://github.com/mermaid-js/mermaid","hn":"https://news.ycombinator.com/item?id=30346598","source":"Hacker News","lang":"en","date":"2022-02-15","points":69,"comments":3},{"title":"Building a Docs-as-Code Workflow With Markdown, Mermaid, and GitHub Actions","url":"https://hackernoon.com/building-a-docs-as-code-workflow-with-markdown-mermaid-and-github-actions","source":"HackerNoon","lang":"en","date":"2026-10-28"},{"title":"GitHub supports 'Mermaid', a library that automatically creates graphs from text","url":"https://gigazine.net/gsc_news/en/20220216-github-mermaid","source":"GIGAZINE","lang":"en","date":"2022-02-16"},{"title":"GitHub Supports Mermaid For Creating Diagrams","url":"https://www.i-programmer.info/news/90-tools/15217-github-supports-mermaid-for-creating-diagrams.html","source":"I Programmer","lang":"en","date":"2022-02-14"},{"title":"GitHub adds native support for JavaScript-based diagramming tool, Mermaid","url":"https://betanews.com/article/github-native-support-mermaid/","source":"BetaNews","lang":"en","date":"2022-02-14"},{"title":"GitHub原生支援在Markdown檔案以Mermaid語法編輯圖表","url":"https://www.ithome.com.tw/news/149380","source":"iThome Online","lang":"zh","date":"2022-02-14"},{"title":"Obsidian creator kepano has released 'Pele,' a lightweight open-source library that uses CSS for theme settings and renders Mermaid diagrams as SVGs.","url":"https://news.google.com/rss/articles/CBMiW0FVX3lxTE1hSFJvVXBwLVRKb2k4ajBxQ2ttczNzSjJuMXR4YkFDa3hiTGQ1R1Izc2xVTHE5cUpNMFduT2NuUmtWUGZrWXkyaGFDWFV3MDlNWlBoblNFRjloZGM?oc=5","source":"GIGAZINE","lang":"en","date":"2026-10-20"},{"title":"GitHub最热架构图Agent，开发者故事看哭了","url":"https://news.google.com/rss/articles/CBMiSEFVX3lxTE95OVAwS0U0X3ZHSXlvM1NxcU13dlEyZ2xuY1dwRHFPNGp2TGRxdldsc3Mwb09RSUFQUGZURXExQnp1X1ZkMUJpYQ?oc=5","source":"智源社区","lang":"zh","date":"2026-09-01"},{"title":"VS Code 1.121 Adds Remote Agents, Boosts Claude Code Functionality Again","url":"https://news.google.com/rss/articles/CBMiwwFBVV95cUxNNE5VS2dpOG1pTlo0bi0tRFREcEFxSl9iRzVuS05EN3IxMFEwbnNaNmdvMk1TR1BXeEJpd2tWNVFfZVNjZ1UxSHMyRmZpUlhlRzVMRUk3a0ZOMkNKZWhJVnZoVXo3dzYxczlqMUhIenhOOVM0VGk2bnRPQVZSTnhEdEhBMGtFMnZrVXBEb2lOckdaVTFPRFlfZWthRVg2QTlaWFJWdWIzdFc0akdXWHVhLVdMUW1aMHNocmpxZ2tYVTVoMk0?oc=5","source":"Visual Studio Magazine","lang":"en","date":"2026-05-20"},{"title":"“让 Token 消耗降低 61%”：腾讯开源 Agent Memory","url":"https://news.google.com/rss/articles/CBMiU0FVX3lxTFBfREhtMUdvMk9GeGFDd3lFV2VmakV4N3FHVm8wbXF2d3ZHaDJ3bG9iTmxpc0hsWGctc29hUTVDNm5QMUJxZnhLMDd6Mkpfb1VlZ3Qw?oc=5","source":"51CTO","lang":"zh","date":"2026-05-15"},{"title":"手搓了一个 Skill，让 AI 画出我心目中的流程图","url":"https://news.google.com/rss/articles/CBMiU0FVX3lxTE5RUnR5TnNEUFJwamc1aTJDVnlrT3Z5N2JURXpoa0JYZUJFNl9iTHpXRkNSMUxVQzIwX09aQk81Tlo2bnRMSFF3ZURzMk9jb0lXWDhj?oc=5","source":"51CTO","lang":"zh","date":"2026-03-27"},{"title":"GitHub Copilot in Visual Studio — January update","url":"https://news.google.com/rss/articles/CBMikgFBVV95cUxOS013WkNPZ3FEQ09Lanc5UUlGV1cxeXg0WjVvVm12em5CYXlrYi1iYmN2cHljWDdLU1pmeGZnclpkRkR2OW9YaUxfbnhIcTdyU0w5bWZqckxaX3ZkUGhhUWJpWGNJN1NFd29JdHdNT1Jtb2dObXQya3JaSWtGWWNSSVBwekRPLURMVzhwMVQwM0RRQQ?oc=5","source":"The GitHub Blog","lang":"en","date":"2026-02-04"},{"title":"Cursor 1.0正式登场，支持画架构图，还支持一键MCP，不过有些抽象","url":"https://news.google.com/rss/articles/CBMiVkFVX3lxTE44QWYxczRrQy02M1dEdmgwbTVmblZIRkdLY1BGX3gtLU1iQW9YYjZ6VGJGczRadGtiTUVSSUNJRHZSblZZdmg5alJ5M3JTZWF4V3VweXRn?oc=5","source":"QQ News","lang":"zh","date":"2025-06-06"},{"title":"再不用怕Markdown中的绘图了，GitHub官方支持Mermaid图表绘制工具","url":"https://news.google.com/rss/articles/CBMieEFVX3lxTFBtSUcxMXk2QXZsRF85SXhsanZXeTFPc1I0dEZrcll0QXpwRl9lZ1JHSy1ncmVWbm56bjhJelM3T0x5T1VMMkExd1c1eGRxTjhvYUpCd21VRVFqdG5TbnRXLXJTeW9Hbk13M0JaTE5kVEQybXlWYmRibw?oc=5","source":"新浪财经","lang":"zh","date":"2022-02-15"},{"title":"Include diagrams in your Markdown files with Mermaid","url":"https://news.google.com/rss/articles/CBMijAFBVV95cUxNd0Nic1BKRDQwdjZZNDNjdllYT2FBYlhTQWgtbzU0aHZaNmhJM2JuUm01bklTdmVYbllzWFJmWGhmdWEzX09WX01JVlpvSm5iY212VDBWdktLNmVoSUw1R0NYaUdybmtBbzJaTzE0Q2JkbFhHQjRnSjYyQnVGdWNSeWQzQmpUSm5zTWJ4Yw?oc=5","source":"The GitHub Blog","lang":"en","date":"2022-02-14"}],"stale":false,"snapshot_at":"2026-11-10T09:35:25Z","history_start":"2026-09-06"}