Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

fix(web): preserve Mermaid links when flowchart omits direction

tianma-if6e4b1b2ee622
diff --git a/apps/web/src/lib/mermaid-renderer.test.mjs b/apps/web/src/lib/mermaid-renderer.test.mjs
index 03f4dd60..ed5e569b 100644
--- a/apps/web/src/lib/mermaid-renderer.test.mjs
+++ b/apps/web/src/lib/mermaid-renderer.test.mjs
@@ -10,6 +10,39 @@ const GANTT_SOURCE = `gantt
Compatibility fallback :fallback, 2026-07-30, 1d`;
describe("Mermaid renderer fallback", () => {
+ test("preserves the reported cross-subgraph links when flowchart omits its direction", () => {
+ const body = `
+ App[应用层] --> Proxy[数据库中间件<br>读写分离 / 分库分表]
+ subgraph DB_Cluster[数据库集群]
+ direction LR
+ Master1[(主库 1)]
+ Master2[(主库 2)]
+ Slave1[(从库 1)]
+ Slave2[(从库 2)]
+ Master1 <-->|双主同步| Master2
+ Master1 -->|主从同步| Slave1
+ Master2 -->|主从同步| Slave2
+ end
+ Proxy -->|写请求| Master1 & Master2
+ Proxy -->|读请求| Slave1 & Slave2`;
+
+ // Isolate ELK from the partial browser globals installed by other suites.
+ const result = spawnSync(process.execPath, ["--eval", `
+ import assert from "node:assert/strict";
+ import { renderThemedMermaidSvg } from "./mermaid-renderer";
+ const body = ${JSON.stringify(body)};
+ const options = { theme: "default", palette: { bg: "#fff", fg: "#000" }, font: "Inter", padding: 24 };
+ const explicit = await renderThemedMermaidSvg("flowchart TD" + body, options);
+ const implicit = await renderThemedMermaidSvg("\\r\\n%% diagram\\r\\nflowchart" + body, options);
+ assert.equal(implicit, explicit);
+ for (const target of ["Master1", "Master2", "Slave1", "Slave2"]) {
+ assert(implicit.includes('data-from="Proxy" data-to="' + target + '"'));
+ }
+ `], { cwd: import.meta.dir, encoding: "utf8", timeout: 30_000 });
+ expect(result.stderr).toBe("");
+ expect(result.status).toBe(0);
+ });
+
test("keeps the reported Chinese subgraph on the compact renderer", async () => {
const source = `flowchart LR
subgraph 日志开启建议
diff --git a/apps/web/src/lib/mermaid-renderer.ts b/apps/web/src/lib/mermaid-renderer.ts
index 3bca663a..00e725ad 100644
--- a/apps/web/src/lib/mermaid-renderer.ts
+++ b/apps/web/src/lib/mermaid-renderer.ts
@@ -24,6 +24,19 @@ let compactModule: Promise<typeof import("beautiful-mermaid")> | undefined;
let officialQueue: Promise<unknown> = Promise.resolve();
let renderSequence = 0;
+const withDefaultFlowchartDirection = (source: string) => {
+ const lines = source.split("\n");
+ const declarationIndex = lines.findIndex((line) => {
+ const trimmed = line.trim();
+ return trimmed.length > 0 && !trimmed.startsWith("%%");
+ });
+ if (lines[declarationIndex]?.trim().toLowerCase() !== "flowchart") return source;
+
+ // Beautiful Mermaid requires an explicit direction even when Mermaid defaults to TD.
+ lines[declarationIndex] = lines[declarationIndex].replace(/flowchart/i, "$& TD");
+ return lines.join("\n");
+};
+
export const renderThemedMermaidSvg = (
source: string,
{ theme, palette, font, padding }: {
@@ -38,7 +51,7 @@ export const renderThemedMermaidSvg = (
// Repository dependency patches preserve CJK group IDs and ELK edge offsets
// (upstream PRs #132 and #152). Keep supported subgraphs on this renderer.
const { renderMermaidSVG, THEMES } = await (compactModule ??= import("beautiful-mermaid"));
- return scaleMermaidSvg(renderMermaidSVG(source, {
+ return scaleMermaidSvg(renderMermaidSVG(withDefaultFlowchartDirection(source), {
...THEMES[theme], ...palette, transparent: true, font, padding,
}));
},