Skip to content

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

feat: expand demo diagram and code samples

tianma-ifa55354cfbe6e
diff --git a/apps/api/src/index.ts b/apps/api/src/index.ts
index 1643fd17..32570670 100644
--- a/apps/api/src/index.ts
+++ b/apps/api/src/index.ts
@@ -306,6 +306,138 @@ const DEMO_SEED_MEMOS_ZH = [
markdown:
"## 富文本与 Markdown 编辑\n\n这条笔记本身就是一个可直接修改的样例:试着改动下面的标题、列表、引用和代码块,然后切换到 Markdown 视图查看对应文本。\n\n### 一份简短清单\n\n- 用标题组织内容层级\n- 用列表拆分行动项\n- 用引用保留原话或关键结论\n\n> 好笔记不是把信息堆起来,而是让下一次找到它时还能立刻行动。\n\n```ts\nconst nextStep = \"把零散想法归入一个笔记本\";\n```\n\nEdgeEver 使用 TipTap 保存结构化正文,同时保留 Markdown 和纯文本索引;API 和 MCP 都可以直接读写 Markdown。\n\n![EdgeEver 编辑器图片示例](/api/v1/resources/res_demo_editor_image/blob)",
},
+ {
+ id: "memo_demo_code_highlighting",
+ notebookId: "nb_demo_features",
+ title: "代码高亮:常见语言示例",
+ tags: ["code", "syntax-highlighting", "demo"],
+ isPinned: true,
+ markdown: [
+ "## 代码高亮:常见语言示例",
+ "",
+ "这条笔记用于体验常见编程语言、配置格式和标记语言的语法高亮效果。每个代码块都保留了语言标识。",
+ "",
+ "### JavaScript / TypeScript",
+ "",
+ "```javascript",
+ "const greet = (name = \"World\") => `Hello, ${name}!`;",
+ "console.log(greet(\"EdgeEver\"));",
+ "```",
+ "",
+ "```typescript",
+ "interface User { id: number; name: string; }",
+ "const user: User = { id: 1, name: \"Ada\" };",
+ "```",
+ "",
+ "### Python / Java / Go / Rust",
+ "",
+ "```python",
+ "from dataclasses import dataclass",
+ "@dataclass",
+ "class Note:",
+ " title: str",
+ " tags: list[str]",
+ "```",
+ "",
+ "```java",
+ "public final class Hello {",
+ " public static void main(String[] args) {",
+ " System.out.println(\"Hello, EdgeEver!\");",
+ " }",
+ "}",
+ "```",
+ "",
+ "```go",
+ "package main",
+ "import \"fmt\"",
+ "func main() { fmt.Println(\"Hello, EdgeEver!\") }",
+ "```",
+ "",
+ "```rust",
+ "fn main() { println!(\"Hello, EdgeEver!\"); }",
+ "```",
+ "",
+ "### C / C++ / C#",
+ "",
+ "```c",
+ "#include <stdio.h>",
+ "int main(void) { printf(\"Hello, EdgeEver!\\n\"); return 0; }",
+ "```",
+ "",
+ "```cpp",
+ "#include <iostream>",
+ "int main() { std::cout << \"Hello, EdgeEver!\" << std::endl; }",
+ "```",
+ "",
+ "```csharp",
+ "Console.WriteLine(\"Hello, EdgeEver!\");",
+ "```",
+ "",
+ "### PHP / Ruby / Swift / Kotlin",
+ "",
+ "```php",
+ "<?php echo \"Hello, EdgeEver!\"; ?>",
+ "```",
+ "",
+ "```ruby",
+ "puts \"Hello, EdgeEver!\"",
+ "```",
+ "",
+ "```swift",
+ "let languages = [\"Swift\", \"Kotlin\"]",
+ "print(languages)",
+ "```",
+ "",
+ "```kotlin",
+ "fun main() { println(\"Hello, EdgeEver!\") }",
+ "```",
+ "",
+ "### Shell / SQL / Web",
+ "",
+ "```bash",
+ "set -euo pipefail",
+ "for file in *.md; do echo \"Checking: $file\"; done",
+ "```",
+ "",
+ "```sql",
+ "SELECT title FROM notes WHERE is_deleted = 0 ORDER BY updated_at DESC;",
+ "```",
+ "",
+ "```html",
+ "<article class=\"note-card\"><h2>代码高亮</h2></article>",
+ "```",
+ "",
+ "```css",
+ ".note-card { color: #1f2937; display: grid; gap: 0.75rem; }",
+ "```",
+ "",
+ "### JSON / YAML / Markdown / Mermaid",
+ "",
+ "```json",
+ "{ \"name\": \"edgeever-demo\", \"highlighting\": true }",
+ "```",
+ "",
+ "```yaml",
+ "app:",
+ " name: edgeever-demo",
+ " syntaxHighlighting: true",
+ "```",
+ "",
+ "```markdown",
+ "# Embedded Markdown",
+ "- headings",
+ "- lists",
+ "- **emphasis**",
+ "```",
+ "",
+ "```mermaid",
+ "flowchart LR",
+ " A[打开笔记] --> B{代码块?}",
+ " B -->|是| C[查看高亮]",
+ " B -->|否| D[继续编辑]",
+ "```",
+ ].join("\n"),
+ },
{
id: "memo_demo_search_tags",
notebookId: "nb_learning",
@@ -352,40 +484,13 @@ const DEMO_SEED_MEMOS_ZH = [
"## Agent-ready:REST API 与 MCP\n\nEdgeEver 提供 REST API、OpenAPI schema 和 MCP endpoint。AI Agent 可以读取笔记本、创建笔记、整理标签,并把导入资料迁移到你的自托管实例。\n\n### 从这里开始\n\n- OpenAPI schema:`/api/openapi.json`\n- MCP endpoint:`/mcp`\n\n一个很小的 Agent 工作流是:先读取「功能演示」笔记本,再把这两条合并素材整理成一条带结论的长期笔记。",
},
{
- id: "memo_demo_mermaid_flowchart",
+ id: "memo_demo_mermaid",
notebookId: "nb_demo_features",
- title: "Mermaid 示例:笔记整理流程",
- tags: ["mermaid", "flowchart", "demo"],
+ title: "Mermaid 示例:常见图表合集",
+ tags: ["mermaid", "diagram", "demo"],
isPinned: true,
markdown:
- "## 笔记整理流程\n\n流程图适合表达判断、分支和处理步骤。进入编辑模式后,可以直接修改下方 Mermaid 源码并查看预览。\n\n```mermaid\nflowchart TD\n A[\"记录灵感\"] --> B{\"需要立即处理?\"}\n B -- \"是\" --> C[\"加入今日行动\"]\n B -- \"否\" --> D[\"放入等待分类\"]\n D --> E{\"是否属于长期主题?\"}\n E -- \"是\" --> F[\"移动到主题笔记本\"]\n E -- \"否\" --> G[\"添加标签并归档\"]\n C --> H[\"完成后沉淀结论\"]\n F --> H\n```\n\n修改节点文字或连线后,图表会自动重新渲染;Markdown 中仍保存标准的 `mermaid` 围栏代码块。",
- },
- {
- id: "memo_demo_mermaid_sequence",
- notebookId: "nb_demo_features",
- title: "Mermaid 示例:离线同步时序",
- tags: ["mermaid", "sequence", "sync"],
- isPinned: false,
- markdown:
- "## 离线同步时序\n\n时序图适合说明多个角色或系统之间按时间发生的交互。\n\n```mermaid\nsequenceDiagram\n actor U as 用户\n participant A as EdgeEver App\n participant Q as 本地同步队列\n participant API as EdgeEver API\n participant DB as D1\n\n U->>A: 编辑并保存笔记\n A->>Q: 写入本地草稿与待同步记录\n A-->>U: 立即显示“已保存到本地”\n Q->>API: 网络恢复后提交更新\n API->>DB: 校验版本并持久化\n DB-->>API: 返回新版本\n API-->>Q: 同步成功\n Q-->>A: 清除待同步记录\n```\n\n这种图很适合记录 API 调用、登录流程、消息队列和跨服务协作。",
- },
- {
- id: "memo_demo_mermaid_state",
- notebookId: "nb_demo_features",
- title: "Mermaid 示例:笔记生命周期",
- tags: ["mermaid", "state-diagram", "workflow"],
- isPinned: false,
- markdown:
- "## 笔记生命周期\n\n状态图强调一个对象会处于哪些状态,以及什么事件会触发状态变化。\n\n```mermaid\nstateDiagram-v2\n [*] --> 草稿\n 草稿 --> 待同步: 离线保存\n 草稿 --> 已保存: 在线保存\n 待同步 --> 已保存: 同步成功\n 待同步 --> 冲突: 服务端版本已变化\n 冲突 --> 草稿: 选择本地版本继续编辑\n 冲突 --> 已保存: 接受服务端版本\n 已保存 --> 已归档: 归档\n 已归档 --> 已保存: 恢复\n 已保存 --> 回收站: 删除\n 回收站 --> 已保存: 恢复\n 回收站 --> [*]: 永久删除\n```\n\n它也适合描述订单、审批单、任务或发布流程。",
- },
- {
- id: "memo_demo_mermaid_gantt",
- notebookId: "nb_demo_features",
- title: "Mermaid 示例:一周发布计划",
- tags: ["mermaid", "gantt", "planning"],
- isPinned: false,
- markdown:
- "## 一周发布计划\n\n甘特图可以把任务、依赖关系和时间安排放在一张图里。\n\n```mermaid\ngantt\n title EdgeEver 功能发布计划\n dateFormat YYYY-MM-DD\n axisFormat %m-%d\n\n section 开发\n 完成 Mermaid 渲染 :done, dev1, 2026-07-20, 2d\n 补齐 App 编辑能力 :done, dev2, after dev1, 1d\n\n section 验证\n 自动化测试 :active, qa1, after dev2, 1d\n Android 与 Web 验收 :qa2, after qa1, 1d\n\n section 发布\n 整理说明与发布 :milestone, release, after qa2, 0d\n```\n\n日期和持续时间都是普通文本,因此可以直接在笔记里维护轻量项目计划。",
+ "## Mermaid 示例:常见图表合集\n\n把常见 Mermaid 图表集中在一条笔记里,方便一次性浏览和对照源码。每个图表都可以单独展开编辑。\n\n### 流程图\n\n流程图适合表达判断、分支和处理步骤。\n\n```mermaid\nflowchart TD\n A[\"记录灵感\"] --> B{\"需要立即处理?\"}\n B -- \"是\" --> C[\"加入今日行动\"]\n B -- \"否\" --> D[\"放入等待分类\"]\n D --> E{\"是否属于长期主题?\"}\n E -- \"是\" --> F[\"移动到主题笔记本\"]\n E -- \"否\" --> G[\"添加标签并归档\"]\n C --> H[\"完成后沉淀结论\"]\n F --> H\n```\n\n### 时序图\n\n时序图适合表达多个角色或系统之间按时间发生的交互。\n\n```mermaid\nsequenceDiagram\n actor U as 用户\n participant A as EdgeEver App\n participant Q as 本地同步队列\n participant API as EdgeEver API\n participant DB as D1\n U->>A: 编辑并保存笔记\n A->>Q: 写入本地草稿与待同步记录\n A-->>U: 立即显示“已保存到本地”\n Q->>API: 网络恢复后提交更新\n API->>DB: 校验版本并持久化\n DB-->>API: 返回新版本\n API-->>Q: 同步成功\n Q-->>A: 清除待同步记录\n```\n\n### 状态图\n\n状态图强调对象会处于哪些状态,以及什么事件会触发状态变化。\n\n```mermaid\nstateDiagram-v2\n [*] --> 草稿\n 草稿 --> 待同步: 离线保存\n 草稿 --> 已保存: 在线保存\n 待同步 --> 已保存: 同步成功\n 待同步 --> 冲突: 服务端版本已变化\n 冲突 --> 草稿: 选择本地版本继续编辑\n 冲突 --> 已保存: 接受服务端版本\n 已保存 --> 已归档: 归档\n 已归档 --> 已保存: 恢复\n 已保存 --> 回收站: 删除\n 回收站 --> 已保存: 恢复\n 回收站 --> [*]: 永久删除\n```\n\n### 甘特图\n\n甘特图可以把任务、依赖关系和时间安排放在一张图里。\n\n```mermaid\ngantt\n title EdgeEver 功能发布计划\n dateFormat YYYY-MM-DD\n axisFormat %m-%d\n section 开发\n 完成 Mermaid 渲染 :done, dev1, 2026-07-20, 2d\n 补齐 App 编辑能力 :done, dev2, after dev1, 1d\n section 验证\n 自动化测试 :active, qa1, after dev2, 1d\n Android 与 Web 验收 :qa2, after qa1, 1d\n section 发布\n 整理说明与发布 :milestone, release, after qa2, 0d\n```\n\n修改节点文字或连线后,图表会自动重新渲染;Markdown 中仍保存标准的 `mermaid` 围栏代码块。",
},
{
id: "memo_demo_mobile",
@@ -472,6 +577,134 @@ const DEMO_MEMO_ENGLISH = {
markdown:
"## Rich Text and Markdown Editor\n\nEdit the headings, list, quote, and code block, then switch to Markdown mode to compare the source. EdgeEver stores structured editor content while keeping Markdown available for APIs and AI Agents.",
},
+ memo_demo_code_highlighting: {
+ title: "Code Highlighting: Common Languages",
+ markdown: [
+ "## Code Highlighting: Common Languages",
+ "",
+ "Preview syntax highlighting for common programming languages, configuration formats, and markup languages. Each fenced block keeps its language identifier.",
+ "",
+ "### JavaScript / TypeScript",
+ "",
+ "```javascript",
+ "const greet = (name = \"World\") => `Hello, ${name}!`;",
+ "console.log(greet(\"EdgeEver\"));",
+ "```",
+ "",
+ "```typescript",
+ "interface User { id: number; name: string; }",
+ "const user: User = { id: 1, name: \"Ada\" };",
+ "```",
+ "",
+ "### Python / Java / Go / Rust",
+ "",
+ "```python",
+ "from dataclasses import dataclass",
+ "@dataclass",
+ "class Note:",
+ " title: str",
+ " tags: list[str]",
+ "```",
+ "",
+ "```java",
+ "public final class Hello {",
+ " public static void main(String[] args) {",
+ " System.out.println(\"Hello, EdgeEver!\");",
+ " }",
+ "}",
+ "```",
+ "",
+ "```go",
+ "package main",
+ "import \"fmt\"",
+ "func main() { fmt.Println(\"Hello, EdgeEver!\") }",
+ "```",
+ "",
+ "```rust",
+ "fn main() { println!(\"Hello, EdgeEver!\"); }",
+ "```",
+ "",
+ "### C / C++ / C#",
+ "",
+ "```c",
+ "#include <stdio.h>",
+ "int main(void) { printf(\"Hello, EdgeEver!\\n\"); return 0; }",
+ "```",
+ "",
+ "```cpp",
+ "#include <iostream>",
+ "int main() { std::cout << \"Hello, EdgeEver!\" << std::endl; }",
+ "```",
+ "",
+ "```csharp",
+ "Console.WriteLine(\"Hello, EdgeEver!\");",
+ "```",
+ "",
+ "### PHP / Ruby / Swift / Kotlin",
+ "",
+ "```php",
+ "<?php echo \"Hello, EdgeEver!\"; ?>",
+ "```",
+ "",
+ "```ruby",
+ "puts \"Hello, EdgeEver!\"",
+ "```",
+ "",
+ "```swift",
+ "let languages = [\"Swift\", \"Kotlin\"]",
+ "print(languages)",
+ "```",
+ "",
+ "```kotlin",
+ "fun main() { println(\"Hello, EdgeEver!\") }",
+ "```",
+ "",
+ "### Shell / SQL / Web",
+ "",
+ "```bash",
+ "set -euo pipefail",
+ "for file in *.md; do echo \"Checking: $file\"; done",
+ "```",
+ "",
+ "```sql",
+ "SELECT title FROM notes WHERE is_deleted = 0 ORDER BY updated_at DESC;",
+ "```",
+ "",
+ "```html",
+ "<article class=\"note-card\"><h2>Code highlighting</h2></article>",
+ "```",
+ "",
+ "```css",
+ ".note-card { color: #1f2937; display: grid; gap: 0.75rem; }",
+ "```",
+ "",
+ "### JSON / YAML / Markdown / Mermaid",
+ "",
+ "```json",
+ "{ \"name\": \"edgeever-demo\", \"highlighting\": true }",
+ "```",
+ "",
+ "```yaml",
+ "app:",
+ " name: edgeever-demo",
+ " syntaxHighlighting: true",
+ "```",
+ "",
+ "```markdown",
+ "# Embedded Markdown",
+ "- headings",
+ "- lists",
+ "- **emphasis**",
+ "```",
+ "",
+ "```mermaid",
+ "flowchart LR",
+ " A[Open note] --> B{Code block?}",
+ " B -->|Yes| C[View highlighting]",
+ " B -->|No| D[Keep editing]",
+ "```",
+ ].join("\n"),
+ },
memo_demo_search_tags: {
title: "Tags, Search, and Archive",
markdown:
@@ -497,25 +730,10 @@ const DEMO_MEMO_ENGLISH = {
markdown:
"## Agent-ready: REST API and MCP\n\nEdgeEver exposes REST, OpenAPI, and MCP endpoints. An AI Agent can read notebooks, create notes, organize tags, and migrate material into a self-hosted instance.\n\n- OpenAPI: `/api/openapi.json`\n- MCP: `/mcp`",
},
- memo_demo_mermaid_flowchart: {
- title: "Mermaid: Note Triage Flowchart",
- markdown:
- "## Note Triage Flowchart\n\nEdit the standard `mermaid` fenced block below and watch the preview update. Flowcharts are useful for decisions, branches, and repeatable workflows.\n\n```mermaid\nflowchart TD\n A[\"Capture an idea\"] --> B{\"Needs action now?\"}\n B -- \"Yes\" --> C[\"Add to today's actions\"]\n B -- \"No\" --> D[\"Put in Inbox\"]\n D --> E{\"Long-term topic?\"}\n E -- \"Yes\" --> F[\"Move to topic notebook\"]\n E -- \"No\" --> G[\"Tag and archive\"]\n```",
- },
- memo_demo_mermaid_sequence: {
- title: "Mermaid: Offline Sync Sequence",
- markdown:
- "## Offline Sync Sequence\n\nSequence diagrams explain interactions between users, apps, queues, APIs, and databases over time. The source remains editable Markdown.\n\n```mermaid\nsequenceDiagram\n actor U as User\n participant A as EdgeEver App\n participant Q as Sync Queue\n participant API as EdgeEver API\n participant DB as D1\n U->>A: Edit and save\n A->>Q: Write local draft\n Q->>API: Submit when online\n API->>DB: Validate revision\n DB-->>API: Return new revision\n API-->>Q: Sync succeeded\n```",
- },
- memo_demo_mermaid_state: {
- title: "Mermaid: Note Lifecycle State Diagram",
- markdown:
- "## Note Lifecycle\n\nState diagrams show the states of an object and the events that move it between states.\n\n```mermaid\nstateDiagram-v2\n [*] --> Draft\n Draft --> PendingSync: Save offline\n Draft --> Saved: Save online\n PendingSync --> Saved: Sync succeeds\n PendingSync --> Conflict: Server version changed\n Conflict --> Draft: Keep local version\n Conflict --> Saved: Accept server version\n Saved --> Archived: Archive\n Saved --> Trash: Delete\n Trash --> Saved: Restore\n```",
- },
- memo_demo_mermaid_gantt: {
- title: "Mermaid: One-week Release Plan",
+ memo_demo_mermaid: {
+ title: "Mermaid: Common Diagram Collection",
markdown:
- "## One-week Release Plan\n\nGantt charts place tasks, dependencies, and dates on one timeline.\n\n```mermaid\ngantt\n title EdgeEver Feature Release\n dateFormat YYYY-MM-DD\n section Build\n Mermaid rendering :done, dev1, 2026-07-20, 2d\n Mobile editor polish :done, dev2, after dev1, 1d\n section Verify\n Automated tests :active, qa1, after dev2, 1d\n Web and Android review :qa2, after qa1, 1d\n```",
+ "## Mermaid: Common Diagram Collection\n\nBrowse common Mermaid diagrams in one note and compare their editable sources. Each diagram can be edited independently.\n\n### Flowchart\n\n```mermaid\nflowchart TD\n A[\"Capture an idea\"] --> B{\"Needs action now?\"}\n B -- \"Yes\" --> C[\"Add to today's actions\"]\n B -- \"No\" --> D[\"Put in Inbox\"]\n D --> E{\"Long-term topic?\"}\n E -- \"Yes\" --> F[\"Move to topic notebook\"]\n E -- \"No\" --> G[\"Tag and archive\"]\n```\n\n### Sequence diagram\n\n```mermaid\nsequenceDiagram\n actor U as User\n participant A as EdgeEver App\n participant Q as Sync Queue\n participant API as EdgeEver API\n participant DB as D1\n U->>A: Edit and save\n A->>Q: Write local draft\n Q->>API: Submit when online\n API->>DB: Validate revision\n DB-->>API: Return new revision\n API-->>Q: Sync succeeded\n```\n\n### State diagram\n\n```mermaid\nstateDiagram-v2\n [*] --> Draft\n Draft --> PendingSync: Save offline\n Draft --> Saved: Save online\n PendingSync --> Saved: Sync succeeds\n PendingSync --> Conflict: Server version changed\n Conflict --> Draft: Keep local version\n Conflict --> Saved: Accept server version\n Saved --> Archived: Archive\n Saved --> Trash: Delete\n Trash --> Saved: Restore\n```\n\n### Gantt chart\n\n```mermaid\ngantt\n title EdgeEver Feature Release\n dateFormat YYYY-MM-DD\n section Build\n Mermaid rendering :done, dev1, 2026-07-20, 2d\n Mobile editor polish :done, dev2, after dev1, 1d\n section Verify\n Automated tests :active, qa1, after dev2, 1d\n Web and Android review :qa2, after qa1, 1d\n```",
},
memo_demo_mobile: {
title: "Mobile and PWA",
diff --git a/apps/web/src/lib/code-block.ts b/apps/web/src/lib/code-block.ts
index e3abaf3f..a884f651 100644
--- a/apps/web/src/lib/code-block.ts
+++ b/apps/web/src/lib/code-block.ts
@@ -14,6 +14,8 @@ export const EdgeEverCodeBlock = CodeBlockLowlight.extend({
export const CODE_BLOCK_LANGUAGES = [
{ value: "plaintext", label: "Plain text" },
{ value: "bash", label: "Bash" },
+ { value: "c", label: "C" },
+ { value: "csharp", label: "C#" },
{ value: "cpp", label: "C++" },
{ value: "css", label: "CSS" },
{ value: "go", label: "Go" },
@@ -21,11 +23,15 @@ export const CODE_BLOCK_LANGUAGES = [
{ value: "java", label: "Java" },
{ value: "javascript", label: "JavaScript" },
{ value: "json", label: "JSON" },
+ { value: "kotlin", label: "Kotlin" },
{ value: "markdown", label: "Markdown" },
{ value: "mermaid", label: "Mermaid" },
+ { value: "php", label: "PHP" },
{ value: "python", label: "Python" },
+ { value: "ruby", label: "Ruby" },
{ value: "rust", label: "Rust" },
{ value: "sql", label: "SQL" },
+ { value: "swift", label: "Swift" },
{ value: "typescript", label: "TypeScript" },
{ value: "yaml", label: "YAML" },
] as const;