Weekly GitHub Report for Mermaid: September 08, 2025 - September 15, 2025 (12:05:27)
Weekly GitHub Report for Mermaid
Thank you for subscribing to our weekly newsletter! Each week, we deliver a comprehensive summary of your GitHub project's latest activity right to your inbox, including an overview of your project's issues, pull requests, contributors, and commit activity.
Table of Contents
I. News
1.1 Recent Version Releases:
The current version of this repository is @mermaid-js/parser@0.4.0
1.2 Version Information:
On March 25, 2025, a minor update was released that introduced the addition of a Radar Chart feature, enhancing the charting capabilities of the platform. This update reflects ongoing efforts to expand visualization options.
II. Issues
2.1 Top 5 Active Issues:
We consider active issues to be issues that that have been commented on most frequently within the last week. Bot comments are omitted.
-
Allows classes for edges: This issue requests the ability to assign CSS-like classes directly to edges in Mermaid diagrams, specifically to differentiate positive and negative causal loop edges by color without needing unique IDs for each edge. The user proposes a syntax to apply classes such as green for positive edges and red for negative edges to simplify styling in causal loop diagrams.
- The comments explain a current workaround where edges must be given unique IDs to apply classes for styling, with examples provided. It is acknowledged that this method is not very convenient, and the user expresses a desire for a simpler syntax that allows class assignment to edges without unique IDs, suggesting this as a potential enhancement.
- Number of comments this week: 4
-
Sequence Diagram does not support JSON configuration: This issue reports a problem where using JSON configuration syntax for sequence diagrams, specifically for Boundary or Control symbols, results in a parsing error instead of generating the expected diagram. The user highlights that while the live editor processes the JSON configuration correctly, adding the same syntax in their environment causes an error, preventing symbol customization in the rendered diagram.
- The comments request additional details about the Mermaid version used, but later suggest that the problem may lie with the Obsidian project rather than Mermaid itself, recommending the issue be closed.
- Number of comments this week: 2
-
ClassDiagram: Relation arrowheads do not adopt relation styling: This issue reports that in class diagrams, the arrowheads on relation lines do not inherit the line color styling applied to the relation itself, resulting in arrowheads remaining black despite the relation line being styled (e.g., green). The user requests that individual relation arrowheads adopt the same color as their respective relation lines, similar to a previously addressed issue in flowcharts, and suggests that a solution involving SVG context-fill and context-stroke properties might be applicable.
- The comment acknowledges the issue and confirms that currently there is no support for arrowhead color styling in class diagrams, but the problem has been noted for consideration.
- Number of comments this week: 1
Since there were fewer than 5 open issues, all of the open issues have been listed above.
2.2 Top 5 Stale Issues:
We consider stale issues to be issues that has had no activity within the last 30 days. The team should work together to get these issues resolved and closed as soon as possible.
- Tooltips for emoji in Diagram Syntax doc tree: This issue proposes adding tooltips to the emoji displayed next to the names of various diagram types in the "Diagram Syntax" section of the documentation tree. The goal is to help users understand the meaning of these icons, as currently there is no reference or explanation available, causing confusion even for experienced users.
- log scale for
xychart-beta: This issue proposes adding ascalestring field to thexychart-betacomponent that defaults tolinearbut can also acceptlogas an option, with the potential to support additional scales in the future. This enhancement would enable users to maintain graph descriptions with true, non-logged values while displaying the data on a logarithmic scale, improving flexibility in data visualization. - Unable to Style Sequence Diagram Title: This issue reports a problem with the Mermaid sequence diagram feature where users are unable to change the font size of the diagram title, resulting in titles that appear very small and difficult to read. The user notes that while other Mermaid graph types support title styling attributes, such as those in QuadrantChartConfig, this functionality is currently missing for sequence diagrams, leading to a reliance on Markdown titles as a workaround.
- SVG rendering formatting issues with markdown input: This issue addresses problems with SVG rendering when nodes contain markdown-formatted text in diagrams, specifically noting that additional height is incorrectly added when opening the SVG in a new tab and that text is cut off when downloading the SVG. These formatting inconsistencies occur despite the node height remaining unchanged, leading to visual discrepancies in the SVG output generated by the Mermaid live editor.
- Vite build error with mermaid version 10.9.0: This issue describes a problem encountered when building a Vue 3 and Vite application that uses Mermaid version 10.9.0 to render graphs. While the graphs display correctly during development, the build process results in a runtime error related to setting a property on an undefined object, causing the application to fail on startup.
2.3 Open Issues
This section lists, groups, and then summarizes issues that were created within the last week in the repository.
Issues Opened This Week: 7
Summarized Issues:
- Rendering Issues in Diagrams: Multiple diagram types in Mermaid exhibit rendering problems, such as segmented rounded corners in state diagrams and abnormal node rendering in mindmaps. These issues affect the visual correctness and output file size, impacting usability and presentation quality.
- issues/6928, issues/6932
- Styling and Customization Limitations: There are limitations in styling diagram elements, including relation arrowheads not inheriting line colors in class diagrams and the inability to assign CSS-like classes directly to edges. These restrictions complicate achieving consistent and flexible visual styles across diagrams.
- issues/6933, issues/6938
- Syntax and Parsing Errors: Using JSON configuration syntax for customizing sequence diagram symbols causes parsing errors in certain Mermaid versions, preventing proper rendering despite compatibility in the live editor. This inconsistency hinders reliable diagram customization through JSON.
- issues/6935
- Feature Requests for Diagram Enhancements: There is a request to add support for data structures like stacks and queues to embed inline diagrams for DSA questions, aiming to improve explanation and understanding of algorithms. Additionally, a complex hierarchical flowchart example illustrates multi-tiered global power structures, highlighting potential for advanced diagramming capabilities.
- issues/6936, issues/6940
2.4 Closed Issues
This section lists, groups, and then summarizes issues that were closed within the last week in the repository. This section also links the associated pull requests if applicable.
Issues Closed This Week: 1
Summarized Issues:
- Project Management Structure: This issue proposes an organizational flowchart for a project management structure in Kaohsiung, detailing roles such as project leader and general manager. It also outlines four execution teams focused on sustainable infrastructure, training and certification, media promotion, and coordination efforts, emphasizing clear role definitions and team responsibilities.
- issues/6937
2.5 Issue Discussion Insights
This section will analyze the tone and sentiment of discussions within this project's open and closed issues that occurred within the past week. It aims to identify potentially heated exchanges and to maintain a constructive project environment.
Based on our analysis, there are no instances of toxic discussions in the project's open or closed issues from the past week.
III. Pull Requests
3.1 Open Pull Requests
This section provides a summary of pull requests that were opened in the repository over the past week. The top three pull requests with the highest number of commits are highlighted as 'key' pull requests. Other pull requests are grouped based on similar characteristics for easier analysis. Up to 25 pull requests are displayed in this section, while any remaining pull requests beyond this limit are omitted for brevity.
Pull Requests Opened This Week: 2
Key Open Pull Requests
1. Fix edge labels to respect htmlLabels=false in flowcharts: This pull request addresses the inconsistent rendering of edge labels in flowcharts by ensuring that when the htmlLabels configuration is set to false, both node and edge labels are rendered as pure SVG
- URL: pull/6929
- Merged: No
2. Specify score range for task syntax: This pull request introduces a specification for the score range in the task syntax of the Mermaid project, including documentation updates and automated fixes, to enhance clarity and functionality.
- URL: pull/6934
- Merged: No
3.2 Closed Pull Requests
This section provides a summary of pull requests that were closed in the repository over the past week. The top three pull requests with the highest number of commits are highlighted as 'key' pull requests. Other pull requests are grouped based on similar characteristics for easier analysis. Up to 25 pull requests are displayed in this section, while any remaining pull requests beyond this limit are omitted for brevity.
Pull Requests Closed This Week: 4
Key Closed Pull Requests
1. chore: Added missing types in diagramDB: This pull request adds missing type definitions for the getDirection and setDirection methods in the DiagramDB interface to align it with their implementations in various diagram types such as erDiagram, classDiagram, FlowChart, stateDiagram, requirementDiagram, and gitGraph.
- URL: pull/6926
- Merged: Yes
2. Chore: Simplify editor selection to single version: This pull request simplifies the editor selection modal in the Mermaid project by consolidating it to use only a single version, as part of a chore to streamline the user interface.
- URL: pull/6930
- Merged: Yes
3. [PR was created by accident -> closed without applying any changes to the repository] Add comprehensive documentation explaining Mermaid's main functionality and key components: This pull request was created by accident and closed without applying any changes, but it originally aimed to add comprehensive documentation explaining Mermaid's main functionality, key components, architecture, diagram types, rendering system, extension capabilities, integration ecosystem, and included detailed code examples and an interactive demonstration.
- URL: pull/6923
- Merged: No
- Associated Commits: 8b1a1
Other Closed Pull Requests
- Build process improvements: This pull request updates the build process for the mermaid live preview by switching the package manager to pnpm. The change resolves Netlify build failures caused by ignoring the mermaid-live-editor lockfile and resulting broken dependencies.
- pull/6939
3.3 Pull Request Discussion Insights
This section will analyze the tone and sentiment of discussions within this project's open and closed pull requests that occurred within the past week. It aims to identify potentially heated exchanges and to maintain a constructive project environment.
Based on our analysis, there are no instances of toxic discussions in the project's open or closed pull requests from the past week.
IV. Contributors
4.1 Contributors
Active Contributors:
We consider an active contributor in this project to be any contributor who has made at least 1 commit, opened at least 1 issue, created at least 1 pull request, or made more than 2 comments in the last month.
If there are more than 10 active contributors, the list is truncated to the top 10 based on contribution metrics for better clarity.
| Contributor | Commits | Pull Requests | Issues | Comments |
|---|---|---|---|---|
| darshanr0107 | 64 | 3 | 0 | 0 |
| sidharthv96 | 24 | 0 | 0 | 2 |
| shubhamparikh2704 | 16 | 0 | 1 | 2 |
| omkarht | 10 | 0 | 0 | 0 |
| RSS1102 | 5 | 0 | 0 | 0 |
| aloisklink | 3 | 1 | 0 | 0 |
| ban-abhijit | 4 | 0 | 0 | 0 |
| shanti2530 | 4 | 0 | 0 | 0 |
| rajat-ht | 2 | 1 | 0 | 1 |
| saurabhg772244 | 2 | 1 | 0 | 0 |