feat: impl text delta support (#14132)

2026-02-19 07:17:00 +08:00 · 2025-12-22 03:16:16 +08:00
parent efbdee5508
commit 321965a424
31 changed files with 2299 additions and 415 deletions
--- a/packages/backend/server/src/tests/e2e/doc-service/snapshots/controller.spec.ts.md
+++ b/packages/backend/server/src/tests/e2e/doc-service/snapshots/controller.spec.ts.md
@@ -9,43 +9,66 @@ Generated by [AVA](https://avajs.dev).
 > Snapshot 1

    {
-      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro. ␊
+      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro.␊
+      ␊
+      ␊
      ␊
      # You own your data, with no compromises␊
+      ␊
      ## Local-first & Real-time collaborative␊
+      ␊
      We love the idea proposed by Ink & Switch in the famous article about you owning your data, despite the cloud. Furthermore, AFFiNE is the first all-in-one workspace that keeps your data ownership with no compromises on real-time collaboration and editing experience.␊
+      ␊
      AFFiNE is a local-first application upon CRDTs with real-time collaboration support. Your data is always stored locally while multiple nodes remain synced in real-time.␊
      ␊
+      ␊
+      ␊
      ### Blocks that assemble your next docs, tasks kanban or whiteboard␊
-      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further. ␊
+      ␊
+      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further.␊
+      ␊
      We are building AFFiNE to be a fundamental open source platform that contains all the building blocks for docs, task management and visual collaboration, hoping you can shape your next workflow with us that can make your life better and also connect others, too.␊
+      ␊
      If you want to learn more about the product design of AFFiNE, here goes the concepts:␊
+      ␊
      To Shape, not to adapt. AFFiNE is built for individuals & teams who care about their data, who refuse vendor lock-in, and who want to have control over their essential tools.␊
+      ␊
      ## A true canvas for blocks in any form␊
-      Many editor apps claimed to be a canvas for productivity. Since the Mother of All Demos, Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers. ␊
+      ␊
+      [Many editor apps](http://notion.so) claimed to be a canvas for productivity. Since _the Mother of All Demos,_ Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers.␊
+      ␊
+      ␊
      ␊
      "We shape our tools and thereafter our tools shape us”. A lot of pioneers have inspired us a long the way, e.g.:␊
-      - Quip & Notion with their great concept of "everything is a block"␊
-      - Trello with their Kanban␊
-      - Airtable & Miro with their no-code programable datasheets␊
-      - Miro & Whimiscal with their edgeless visual whiteboard␊
-      - Remnote & Capacities with their object-based tag system␊
-      For more details, please refer to our RoadMap␊
+      ␊
+      * Quip & Notion with their great concept of "everything is a block"␊
+      * Trello with their Kanban␊
+      * Airtable & Miro with their no-code programable datasheets␊
+      * Miro & Whimiscal with their edgeless visual whiteboard␊
+      * Remnote & Capacities with their object-based tag system␊
+      For more details, please refer to our [RoadMap](https://docs.affine.pro/docs/core-concepts/roadmap)␊
+      ␊
      ## Self Host␊
+      ␊
      Self host AFFiNE␊
      ␊
+      ␊
      ### Learning From␊
      ||Title|Tag|␊
      |---|---|---|␊
-      |Affine Development|Affine Development||␊
-      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc||␊
-      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"||␊
-      |Trello with their Kanban|Trello with their Kanban||␊
-      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets||␊
-      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard||␊
+      |Affine Development|Affine Development|<span data-affine-option data-value="AxSe-53xjX" data-option-color="var(--affine-tag-pink)">AFFiNE</span>|␊
+      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc|<span data-affine-option data-value="0jh9gNw4Yl" data-option-color="var(--affine-tag-orange)">Developers</span>|␊
+      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Trello with their Kanban|Trello with their Kanban|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
      |Remnote & Capacities with their object-based tag system|Remnote & Capacities with their object-based tag system||␊
+      ␊
      ## Affine Development␊
-      For developer or installation guides, please go to AFFiNE Development␊
+      ␊
+      For developer or installation guides, please go to [AFFiNE Development](https://docs.affine.pro/docs/development/quick-start)␊
+      ␊
+      ␊
      ␊
      `,
      title: 'Write, Draw, Plan all at Once.',
--- a/packages/backend/server/src/tests/e2e/doc-service/snapshots/controller.spec.ts.snap
+++ b/packages/backend/server/src/tests/e2e/doc-service/snapshots/controller.spec.ts.snap
--- a/packages/backend/server/src/core/doc/tests/snapshots/reader-from-database.spec.ts.md
+++ b/packages/backend/server/src/core/doc/tests/snapshots/reader-from-database.spec.ts.md
@@ -9,43 +9,66 @@ Generated by [AVA](https://avajs.dev).
 > Snapshot 1

    {
-      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro. ␊
+      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro.␊
+      ␊
+      ␊
      ␊
      # You own your data, with no compromises␊
+      ␊
      ## Local-first & Real-time collaborative␊
+      ␊
      We love the idea proposed by Ink & Switch in the famous article about you owning your data, despite the cloud. Furthermore, AFFiNE is the first all-in-one workspace that keeps your data ownership with no compromises on real-time collaboration and editing experience.␊
+      ␊
      AFFiNE is a local-first application upon CRDTs with real-time collaboration support. Your data is always stored locally while multiple nodes remain synced in real-time.␊
      ␊
+      ␊
+      ␊
      ### Blocks that assemble your next docs, tasks kanban or whiteboard␊
-      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further. ␊
+      ␊
+      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further.␊
+      ␊
      We are building AFFiNE to be a fundamental open source platform that contains all the building blocks for docs, task management and visual collaboration, hoping you can shape your next workflow with us that can make your life better and also connect others, too.␊
+      ␊
      If you want to learn more about the product design of AFFiNE, here goes the concepts:␊
+      ␊
      To Shape, not to adapt. AFFiNE is built for individuals & teams who care about their data, who refuse vendor lock-in, and who want to have control over their essential tools.␊
+      ␊
      ## A true canvas for blocks in any form␊
-      Many editor apps claimed to be a canvas for productivity. Since the Mother of All Demos, Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers. ␊
+      ␊
+      [Many editor apps](http://notion.so) claimed to be a canvas for productivity. Since _the Mother of All Demos,_ Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers.␊
+      ␊
+      ␊
      ␊
      "We shape our tools and thereafter our tools shape us”. A lot of pioneers have inspired us a long the way, e.g.:␊
-      - Quip & Notion with their great concept of "everything is a block"␊
-      - Trello with their Kanban␊
-      - Airtable & Miro with their no-code programable datasheets␊
-      - Miro & Whimiscal with their edgeless visual whiteboard␊
-      - Remnote & Capacities with their object-based tag system␊
-      For more details, please refer to our RoadMap␊
+      ␊
+      * Quip & Notion with their great concept of "everything is a block"␊
+      * Trello with their Kanban␊
+      * Airtable & Miro with their no-code programable datasheets␊
+      * Miro & Whimiscal with their edgeless visual whiteboard␊
+      * Remnote & Capacities with their object-based tag system␊
+      For more details, please refer to our [RoadMap](https://docs.affine.pro/docs/core-concepts/roadmap)␊
+      ␊
      ## Self Host␊
+      ␊
      Self host AFFiNE␊
      ␊
+      ␊
      ### Learning From␊
      ||Title|Tag|␊
      |---|---|---|␊
-      |Affine Development|Affine Development||␊
-      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc||␊
-      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"||␊
-      |Trello with their Kanban|Trello with their Kanban||␊
-      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets||␊
-      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard||␊
+      |Affine Development|Affine Development|<span data-affine-option data-value="AxSe-53xjX" data-option-color="var(--affine-tag-pink)">AFFiNE</span>|␊
+      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc|<span data-affine-option data-value="0jh9gNw4Yl" data-option-color="var(--affine-tag-orange)">Developers</span>|␊
+      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Trello with their Kanban|Trello with their Kanban|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
      |Remnote & Capacities with their object-based tag system|Remnote & Capacities with their object-based tag system||␊
+      ␊
      ## Affine Development␊
-      For developer or installation guides, please go to AFFiNE Development␊
+      ␊
+      For developer or installation guides, please go to [AFFiNE Development](https://docs.affine.pro/docs/development/quick-start)␊
+      ␊
+      ␊
      ␊
      `,
      title: 'Write, Draw, Plan all at Once.',
--- a/packages/backend/server/src/core/doc/tests/snapshots/reader-from-database.spec.ts.snap
+++ b/packages/backend/server/src/core/doc/tests/snapshots/reader-from-database.spec.ts.snap
--- a/packages/backend/server/src/core/doc/tests/snapshots/reader-from-rpc.spec.ts.md
+++ b/packages/backend/server/src/core/doc/tests/snapshots/reader-from-rpc.spec.ts.md
@@ -9,43 +9,66 @@ Generated by [AVA](https://avajs.dev).
 > Snapshot 1

    {
-      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro. ␊
+      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro.␊
+      ␊
+      ␊
      ␊
      # You own your data, with no compromises␊
+      ␊
      ## Local-first & Real-time collaborative␊
+      ␊
      We love the idea proposed by Ink & Switch in the famous article about you owning your data, despite the cloud. Furthermore, AFFiNE is the first all-in-one workspace that keeps your data ownership with no compromises on real-time collaboration and editing experience.␊
+      ␊
      AFFiNE is a local-first application upon CRDTs with real-time collaboration support. Your data is always stored locally while multiple nodes remain synced in real-time.␊
      ␊
+      ␊
+      ␊
      ### Blocks that assemble your next docs, tasks kanban or whiteboard␊
-      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further. ␊
+      ␊
+      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further.␊
+      ␊
      We are building AFFiNE to be a fundamental open source platform that contains all the building blocks for docs, task management and visual collaboration, hoping you can shape your next workflow with us that can make your life better and also connect others, too.␊
+      ␊
      If you want to learn more about the product design of AFFiNE, here goes the concepts:␊
+      ␊
      To Shape, not to adapt. AFFiNE is built for individuals & teams who care about their data, who refuse vendor lock-in, and who want to have control over their essential tools.␊
+      ␊
      ## A true canvas for blocks in any form␊
-      Many editor apps claimed to be a canvas for productivity. Since the Mother of All Demos, Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers. ␊
+      ␊
+      [Many editor apps](http://notion.so) claimed to be a canvas for productivity. Since _the Mother of All Demos,_ Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers.␊
+      ␊
+      ␊
      ␊
      "We shape our tools and thereafter our tools shape us”. A lot of pioneers have inspired us a long the way, e.g.:␊
-      - Quip & Notion with their great concept of "everything is a block"␊
-      - Trello with their Kanban␊
-      - Airtable & Miro with their no-code programable datasheets␊
-      - Miro & Whimiscal with their edgeless visual whiteboard␊
-      - Remnote & Capacities with their object-based tag system␊
-      For more details, please refer to our RoadMap␊
+      ␊
+      * Quip & Notion with their great concept of "everything is a block"␊
+      * Trello with their Kanban␊
+      * Airtable & Miro with their no-code programable datasheets␊
+      * Miro & Whimiscal with their edgeless visual whiteboard␊
+      * Remnote & Capacities with their object-based tag system␊
+      For more details, please refer to our [RoadMap](https://docs.affine.pro/docs/core-concepts/roadmap)␊
+      ␊
      ## Self Host␊
+      ␊
      Self host AFFiNE␊
      ␊
+      ␊
      ### Learning From␊
      ||Title|Tag|␊
      |---|---|---|␊
-      |Affine Development|Affine Development||␊
-      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc||␊
-      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"||␊
-      |Trello with their Kanban|Trello with their Kanban||␊
-      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets||␊
-      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard||␊
+      |Affine Development|Affine Development|<span data-affine-option data-value="AxSe-53xjX" data-option-color="var(--affine-tag-pink)">AFFiNE</span>|␊
+      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc|<span data-affine-option data-value="0jh9gNw4Yl" data-option-color="var(--affine-tag-orange)">Developers</span>|␊
+      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Trello with their Kanban|Trello with their Kanban|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
      |Remnote & Capacities with their object-based tag system|Remnote & Capacities with their object-based tag system||␊
+      ␊
      ## Affine Development␊
-      For developer or installation guides, please go to AFFiNE Development␊
+      ␊
+      For developer or installation guides, please go to [AFFiNE Development](https://docs.affine.pro/docs/development/quick-start)␊
+      ␊
+      ␊
      ␊
      `,
      title: 'Write, Draw, Plan all at Once.',
--- a/packages/backend/server/src/core/doc/tests/snapshots/reader-from-rpc.spec.ts.snap
+++ b/packages/backend/server/src/core/doc/tests/snapshots/reader-from-rpc.spec.ts.snap
--- a/packages/backend/server/src/core/doc/reader.ts
+++ b/packages/backend/server/src/core/doc/reader.ts
@@ -192,7 +192,12 @@ export class DatabaseDocReader extends DocReader {
    if (!doc) {
      return null;
    }
-    return parseDocToMarkdownFromDocSnapshot(docId, doc.bin, aiEditable);
+    return parseDocToMarkdownFromDocSnapshot(
+      workspaceId,
+      docId,
+      doc.bin,
+      aiEditable
+    );
  }

  async getDocDiff(
--- a/packages/backend/server/src/core/utils/tests/snapshots/blocksute.spec.ts.md
+++ b/packages/backend/server/src/core/utils/tests/snapshots/blocksute.spec.ts.md
@@ -1379,43 +1379,66 @@ Generated by [AVA](https://avajs.dev).
 > Snapshot 1

    {
-      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro. ␊
+      markdown: `AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro.␊
+      ␊
+      ␊
      ␊
      # You own your data, with no compromises␊
+      ␊
      ## Local-first & Real-time collaborative␊
+      ␊
      We love the idea proposed by Ink & Switch in the famous article about you owning your data, despite the cloud. Furthermore, AFFiNE is the first all-in-one workspace that keeps your data ownership with no compromises on real-time collaboration and editing experience.␊
+      ␊
      AFFiNE is a local-first application upon CRDTs with real-time collaboration support. Your data is always stored locally while multiple nodes remain synced in real-time.␊
      ␊
+      ␊
+      ␊
      ### Blocks that assemble your next docs, tasks kanban or whiteboard␊
-      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further. ␊
+      ␊
+      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further.␊
+      ␊
      We are building AFFiNE to be a fundamental open source platform that contains all the building blocks for docs, task management and visual collaboration, hoping you can shape your next workflow with us that can make your life better and also connect others, too.␊
+      ␊
      If you want to learn more about the product design of AFFiNE, here goes the concepts:␊
+      ␊
      To Shape, not to adapt. AFFiNE is built for individuals & teams who care about their data, who refuse vendor lock-in, and who want to have control over their essential tools.␊
+      ␊
      ## A true canvas for blocks in any form␊
-      Many editor apps claimed to be a canvas for productivity. Since the Mother of All Demos, Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers. ␊
+      ␊
+      [Many editor apps](http://notion.so) claimed to be a canvas for productivity. Since _the Mother of All Demos,_ Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers.␊
+      ␊
+      ␊
      ␊
      "We shape our tools and thereafter our tools shape us”. A lot of pioneers have inspired us a long the way, e.g.:␊
-      - Quip & Notion with their great concept of "everything is a block"␊
-      - Trello with their Kanban␊
-      - Airtable & Miro with their no-code programable datasheets␊
-      - Miro & Whimiscal with their edgeless visual whiteboard␊
-      - Remnote & Capacities with their object-based tag system␊
-      For more details, please refer to our RoadMap␊
+      ␊
+      * Quip & Notion with their great concept of "everything is a block"␊
+      * Trello with their Kanban␊
+      * Airtable & Miro with their no-code programable datasheets␊
+      * Miro & Whimiscal with their edgeless visual whiteboard␊
+      * Remnote & Capacities with their object-based tag system␊
+      For more details, please refer to our [RoadMap](https://docs.affine.pro/docs/core-concepts/roadmap)␊
+      ␊
      ## Self Host␊
+      ␊
      Self host AFFiNE␊
      ␊
+      ␊
      ### Learning From␊
      ||Title|Tag|␊
      |---|---|---|␊
-      |Affine Development|Affine Development||␊
-      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc||␊
-      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"||␊
-      |Trello with their Kanban|Trello with their Kanban||␊
-      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets||␊
-      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard||␊
+      |Affine Development|Affine Development|<span data-affine-option data-value="AxSe-53xjX" data-option-color="var(--affine-tag-pink)">AFFiNE</span>|␊
+      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc|<span data-affine-option data-value="0jh9gNw4Yl" data-option-color="var(--affine-tag-orange)">Developers</span>|␊
+      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Trello with their Kanban|Trello with their Kanban|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
      |Remnote & Capacities with their object-based tag system|Remnote & Capacities with their object-based tag system||␊
+      ␊
      ## Affine Development␊
-      For developer or installation guides, please go to AFFiNE Development␊
+      ␊
+      For developer or installation guides, please go to [AFFiNE Development](https://docs.affine.pro/docs/development/quick-start)␊
+      ␊
+      ␊
      ␊
      `,
      title: 'Write, Draw, Plan all at Once.',
@@ -1427,49 +1450,72 @@ Generated by [AVA](https://avajs.dev).

    {
      markdown: `<!-- block_id=RX4CG2zsBk flavour=affine:note -->␊
-      AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro. ␊
+      AFFiNE is an open source all in one workspace, an operating system for all the building blocks of your team wiki, knowledge management and digital assets and a better alternative to Notion and Miro.␊
+      ␊
+      ␊
      ␊
      # You own your data, with no compromises␊
+      ␊
      ## Local-first & Real-time collaborative␊
+      ␊
      We love the idea proposed by Ink & Switch in the famous article about you owning your data, despite the cloud. Furthermore, AFFiNE is the first all-in-one workspace that keeps your data ownership with no compromises on real-time collaboration and editing experience.␊
+      ␊
      AFFiNE is a local-first application upon CRDTs with real-time collaboration support. Your data is always stored locally while multiple nodes remain synced in real-time.␊
      ␊
+      ␊
+      ␊
      <!-- block_id=S1mkc8zUoU flavour=affine:note -->␊
      ### Blocks that assemble your next docs, tasks kanban or whiteboard␊
+      ␊
      <!-- block_id=yGlBdshAqN flavour=affine:note -->␊
-      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further. ␊
+      There is a large overlap of their atomic "building blocks" between these apps. They are neither open source nor have a plugin system like VS Code for contributors to customize. We want to have something that contains all the features we love and goes one step further.␊
+      ␊
      We are building AFFiNE to be a fundamental open source platform that contains all the building blocks for docs, task management and visual collaboration, hoping you can shape your next workflow with us that can make your life better and also connect others, too.␊
+      ␊
      If you want to learn more about the product design of AFFiNE, here goes the concepts:␊
+      ␊
      To Shape, not to adapt. AFFiNE is built for individuals & teams who care about their data, who refuse vendor lock-in, and who want to have control over their essential tools.␊
+      ␊
      <!-- block_id=6lDiuDqZGL flavour=affine:note -->␊
      ## A true canvas for blocks in any form␊
-      Many editor apps claimed to be a canvas for productivity. Since the Mother of All Demos, Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers. ␊
+      ␊
+      [Many editor apps](http://notion.so) claimed to be a canvas for productivity. Since _the Mother of All Demos,_ Douglas Engelbart, a creative and programable digital workspace has been a pursuit and an ultimate mission for generations of tool makers.␊
+      ␊
+      ␊
      ␊
      "We shape our tools and thereafter our tools shape us”. A lot of pioneers have inspired us a long the way, e.g.:␊
-      - Quip & Notion with their great concept of "everything is a block"␊
-      - Trello with their Kanban␊
-      - Airtable & Miro with their no-code programable datasheets␊
-      - Miro & Whimiscal with their edgeless visual whiteboard␊
-      - Remnote & Capacities with their object-based tag system␊
+      ␊
+      * Quip & Notion with their great concept of "everything is a block"␊
+      * Trello with their Kanban␊
+      * Airtable & Miro with their no-code programable datasheets␊
+      * Miro & Whimiscal with their edgeless visual whiteboard␊
+      * Remnote & Capacities with their object-based tag system␊
      <!-- block_id=cauvaHOQmh flavour=affine:note -->␊
-      For more details, please refer to our RoadMap␊
+      For more details, please refer to our [RoadMap](https://docs.affine.pro/docs/core-concepts/roadmap)␊
+      ␊
      ## Self Host␊
+      ␊
      Self host AFFiNE␊
+      ␊
      <!-- block_id=2jwCeO8Yot flavour=affine:note -->␊
      ␊
      ### Learning From␊
      ||Title|Tag|␊
      |---|---|---|␊
-      |Affine Development|Affine Development||␊
-      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc||␊
-      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"||␊
-      |Trello with their Kanban|Trello with their Kanban||␊
-      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets||␊
-      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard||␊
+      |Affine Development|Affine Development|<span data-affine-option data-value="AxSe-53xjX" data-option-color="var(--affine-tag-pink)">AFFiNE</span>|␊
+      |For developers or installations guides, please go to AFFiNE Doc|For developers or installations guides, please go to AFFiNE Doc|<span data-affine-option data-value="0jh9gNw4Yl" data-option-color="var(--affine-tag-orange)">Developers</span>|␊
+      |Quip & Notion with their great concept of "everything is a block"|Quip & Notion with their great concept of "everything is a block"|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Trello with their Kanban|Trello with their Kanban|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Airtable & Miro with their no-code programable datasheets|Airtable & Miro with their no-code programable datasheets|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
+      |Miro & Whimiscal with their edgeless visual whiteboard|Miro & Whimiscal with their edgeless visual whiteboard|<span data-affine-option data-value="HgHsKOUINZ" data-option-color="var(--affine-tag-blue)">Reference</span>|␊
      |Remnote & Capacities with their object-based tag system|Remnote & Capacities with their object-based tag system||␊
+      ␊
      <!-- block_id=c9MF_JiRgx flavour=affine:note -->␊
      ## Affine Development␊
-      For developer or installation guides, please go to AFFiNE Development␊
+      ␊
+      For developer or installation guides, please go to [AFFiNE Development](https://docs.affine.pro/docs/development/quick-start)␊
+      ␊
+      ␊
      ␊
      <!-- block_id=6x7ALjUDjj flavour=affine:surface -->␊
      `,
--- a/packages/backend/server/src/core/utils/tests/snapshots/blocksute.spec.ts.snap
+++ b/packages/backend/server/src/core/utils/tests/snapshots/blocksute.spec.ts.snap
--- a/packages/backend/server/src/core/utils/tests/blocksute.spec.ts
+++ b/packages/backend/server/src/core/utils/tests/blocksute.spec.ts
@@ -79,6 +79,7 @@ test('can read all blocks from doc snapshot without workspace snapshot', async t

 test('can parse doc to markdown from doc snapshot', async t => {
  const result = parseDocToMarkdownFromDocSnapshot(
+    workspace.id,
    docSnapshot.id,
    docSnapshot.blob
  );
@@ -88,6 +89,7 @@ test('can parse doc to markdown from doc snapshot', async t => {

 test('can parse doc to markdown from doc snapshot with ai editable', async t => {
  const result = parseDocToMarkdownFromDocSnapshot(
+    workspace.id,
    docSnapshot.id,
    docSnapshot.blob,
    true
--- a/packages/backend/server/src/core/utils/blocksuite.ts
+++ b/packages/backend/server/src/core/utils/blocksuite.ts
@@ -188,14 +188,17 @@ export async function readAllBlocksFromDocSnapshot(
 }

 export function parseDocToMarkdownFromDocSnapshot(
+  workspaceId: string,
  docId: string,
  docSnapshot: Uint8Array,
  aiEditable = false
 ) {
+  const docUrlPrefix = workspaceId ? `/workspace/${workspaceId}` : undefined;
  const parsed = parseYDocToMarkdown(
    Buffer.from(docSnapshot),
    docId,
-    aiEditable
+    aiEditable,
+    docUrlPrefix
  );

  return {