diff --git a/apps/website/content/roam/use-cases/share-your-ideas-and-research.md b/apps/website/content/roam/use-cases/share-your-ideas-and-research.md
deleted file mode 100644
index 414547b7f..000000000
--- a/apps/website/content/roam/use-cases/share-your-ideas-and-research.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-title: "Share your ideas & research"
-date: "2026-06-29"
-author: ""
-published: true
----
-
-Description coming soon!
-
-## What else would you like to do?
-
-- [Build and utilize a personal knowledge base](/docs/roam/use-cases/build-utilize-personal-knowledge-base)
-- [Synthesize insights from the literature](/docs/roam/use-cases/synthesize-insights-from-literature)
-- [Track your projects and experiments](/docs/roam/use-cases/track-your-projects-and-experiments)
diff --git a/apps/website/content/roam/use-cases/share-your-ideas-and-research.mdx b/apps/website/content/roam/use-cases/share-your-ideas-and-research.mdx
new file mode 100644
index 000000000..cda0b7525
--- /dev/null
+++ b/apps/website/content/roam/use-cases/share-your-ideas-and-research.mdx
@@ -0,0 +1,229 @@
+---
+title: "Share your ideas & research"
+date: "2026-06-29"
+author: ""
+published: true
+---
+
+import Image from "next/image";
+import { Callout } from "nextra/components";
+
+You've built your graph, a work of beauty and insight. Now you're ready to share what you've learned.
+
+
+_Getting eyes on the prize_
+
+- [Sharing your discourse graph](#sharing-your-discourse-graph)
+- [Sharing your discourse canvas](#sharing-your-discourse-canvas)
+- [Drafting a manuscript from your discourse graph](#drafting-a-manuscript-from-your-discourse-graph)
+
+## Sharing your discourse graph
+
+Roam Research is cloud-hosted, and its web, desktop, and mobile clients have built-in collaboration features.
+
+To create a multiplayer graph with shared access and authorship, go to `Settings → Sharing` and enter the email addresses of the people you want to share your graph with. You can also set read/write access permissions here.
+
+
+_Roam graph sharing settings_
+
+
+ Sharing your graph shares all parts of your graph; there are no private pages
+ in a shared Roam graph.
+
+
+You can share individual pages from your graph as Markdown or JSON files. These pages can be imported into another Roam graph (JSON is best for this) or read as text files (Markdown is best for this).
+
+
+_Exporting pages from your graph_
+
+You can also export the results of a query in a variety of human- and machine-readable formats.
+
+
+_Exporting query results_
+
+## Sharing your discourse canvas
+
+### Presenting your canvas
+
+Your canvas can be used to give a PowerPoint- or Figma-like visual overview of your work.
+
+You can start at your motivating question and move through your hypothesis to your experiments and their results, opening each node in the sidebar to show your audience relevant details.
+
+
+_Example canvas walkthrough_
+
+You can create a "presentation view" for your discourse nodes by adding the material or images you want to highlight at the top of the page. The first image on the page is automatically selected as the image that displays on the discourse canvas.
+
+
+ You can modify your discourse templates to customize your presentation view.
+ Check out [this
+ tutorial](https://roamresearch.com/#/app/template-lab/page/NlmtT4SQa) in the
+ template lab graph for tips.
+
+
+### Exporting your canvas
+
+You can export your canvas as JSON or as a static .png or .svg image.
+
+
+_The canvas menu_
+
+
+ It is not possible at present to export a "live" discourse canvas to another
+ graph.
+
+
+### Coworking on your canvas
+
+Any canvas in your graph can be edited or viewed by anyone who has the appropriate permissions in your graph. The **cloud canvas** feature supports real-time multiplayer collaboration between members of your graph: a shared whiteboard session where you can see others' edits as soon as they appear.
+
+
+_Enabling the cloud canvas_
+
+The cloud canvas is useful for shared brainstorming or manuscript planning sprints.
+
+## Drafting a manuscript from your discourse graph
+
+### Using the canvas as a storyboard
+
+You can use the discourse canvas to organize your ideas for a paper. Your canvas lets you follow your train of thought from hypothesis formation to hypothesis testing, including the dead ends. You can see at a glance which sources (references) were crucial to the formulation of certain claims, and which informed the design of your experiments.
+
+If you're targeting a particular journal, you might find it helpful to spatially arrange your discourse nodes according to its manuscript submission format. This can give you a head start on the drafting stage.
+
+
+_Using canvas layers to organize article sections_
+
+The canvas layout can also be used to spot "gaps" in your argument at a glance, before Reviewer #2 rushes in to fill them with part of their oeuvre.
+
+
+_Mind the gap: spotting unsupported claims before Reviewer #2_
+
+The canvas is also useful for selecting and arranging figures, particularly for deciding which images should be composed into figure panels, and which visual evidence is crucial enough to highlight in the main body of the text versus the supplementary information.
+
+
+_Details of the experiment can go in one section..._
+
+
+_... and the results in another_
+
+### Arguing with your graph
+
+Your discourse nodes should be formulated as concisely as possible, but the rest of the page can be used to construct and elaborate your broader point. The example below links both **Evidence** and **Caveats** related to a **Claim**. In this discourse context, a _Caveat_ is an observation that weakens the claim without necessarily opposing it. Some caveats may be promoted to Evidence that _opposes_ a Claim after further investigation, others may become **Issues**: requests for additional analyses to clarify a point. Anticipating the most salient caveats to each of your claims is useful preparation for the review stage of your manuscript submission.
+
+
+_An example of a claim with caveats_
+
+You can [modify your discourse graph templates](https://roamresearch.com/#/app/template-lab/page/NlmtT4SQa) to structure key information in a way that facilitates article writing later.
+
+
+_An example of an evidence node with methods context_
+
+Discourse nodes are modular and composable, and you can reuse them across multiple projects. One strategy to maximize composability is to capture "evergreen" information in the node template and add project-specific context in the "log" section.
+
+
+_A claim template with a "Notes" section for logging observations in the context
+of a specific project_
+
+## Exporting your graph
+
+You can export your entire discourse graph in a format suitable for import into another Roam Research graph by selecting "Export All" from the Roam Settings menu and choosing "msgpack." You can also export your graph as JSON or Markdown for import into other programs.
+
+
+_Exporting your entire graph_
+
+## What else would you like to do?
+
+- [Build and utilize a personal knowledge base](/docs/roam/use-cases/build-utilize-personal-knowledge-base)
+- [Synthesize insights from the literature](/docs/roam/use-cases/synthesize-insights-from-literature)
+- [Track your projects and experiments](/docs/roam/use-cases/track-your-projects-and-experiments)
diff --git a/apps/website/public/docs/roam/cloud-canvas-toggle.png b/apps/website/public/docs/roam/cloud-canvas-toggle.png
new file mode 100644
index 000000000..8a33e1310
Binary files /dev/null and b/apps/website/public/docs/roam/cloud-canvas-toggle.png differ
diff --git a/apps/website/public/docs/roam/draft-manu01.png b/apps/website/public/docs/roam/draft-manu01.png
new file mode 100644
index 000000000..22f1fc27b
Binary files /dev/null and b/apps/website/public/docs/roam/draft-manu01.png differ
diff --git a/apps/website/public/docs/roam/fig-panel01.png b/apps/website/public/docs/roam/fig-panel01.png
new file mode 100644
index 000000000..454ec6c52
Binary files /dev/null and b/apps/website/public/docs/roam/fig-panel01.png differ
diff --git a/apps/website/public/docs/roam/fig-panel02.png b/apps/website/public/docs/roam/fig-panel02.png
new file mode 100644
index 000000000..fbdce1734
Binary files /dev/null and b/apps/website/public/docs/roam/fig-panel02.png differ
diff --git a/apps/website/public/docs/roam/graph-arg01.png b/apps/website/public/docs/roam/graph-arg01.png
new file mode 100644
index 000000000..6b8f41187
Binary files /dev/null and b/apps/website/public/docs/roam/graph-arg01.png differ
diff --git a/apps/website/public/docs/roam/graph-arg02.png b/apps/website/public/docs/roam/graph-arg02.png
new file mode 100644
index 000000000..f0aebbde1
Binary files /dev/null and b/apps/website/public/docs/roam/graph-arg02.png differ
diff --git a/apps/website/public/docs/roam/graph-arg03.png b/apps/website/public/docs/roam/graph-arg03.png
new file mode 100644
index 000000000..47fb4e19c
Binary files /dev/null and b/apps/website/public/docs/roam/graph-arg03.png differ
diff --git a/apps/website/public/docs/roam/roam-canvas-walkthrough.gif b/apps/website/public/docs/roam/roam-canvas-walkthrough.gif
new file mode 100644
index 000000000..c262c29a2
Binary files /dev/null and b/apps/website/public/docs/roam/roam-canvas-walkthrough.gif differ
diff --git a/apps/website/public/docs/roam/roam-export-canvas.png b/apps/website/public/docs/roam/roam-export-canvas.png
new file mode 100644
index 000000000..67565255a
Binary files /dev/null and b/apps/website/public/docs/roam/roam-export-canvas.png differ
diff --git a/apps/website/public/docs/roam/roam-graph-ex01.png b/apps/website/public/docs/roam/roam-graph-ex01.png
new file mode 100644
index 000000000..b2b7cca84
Binary files /dev/null and b/apps/website/public/docs/roam/roam-graph-ex01.png differ
diff --git a/apps/website/public/docs/roam/roam-graph-ex02.png b/apps/website/public/docs/roam/roam-graph-ex02.png
new file mode 100644
index 000000000..4ae0fa3db
Binary files /dev/null and b/apps/website/public/docs/roam/roam-graph-ex02.png differ
diff --git a/apps/website/public/docs/roam/roam-graph-ex03.png b/apps/website/public/docs/roam/roam-graph-ex03.png
new file mode 100644
index 000000000..32ff0b815
Binary files /dev/null and b/apps/website/public/docs/roam/roam-graph-ex03.png differ
diff --git a/apps/website/public/docs/roam/roam-share-settings.png b/apps/website/public/docs/roam/roam-share-settings.png
new file mode 100644
index 000000000..19f879bfa
Binary files /dev/null and b/apps/website/public/docs/roam/roam-share-settings.png differ
diff --git a/apps/website/public/docs/roam/share-query-result.png b/apps/website/public/docs/roam/share-query-result.png
new file mode 100644
index 000000000..5ed8feb86
Binary files /dev/null and b/apps/website/public/docs/roam/share-query-result.png differ
diff --git a/apps/website/public/docs/roam/share-roam-export.png b/apps/website/public/docs/roam/share-roam-export.png
new file mode 100644
index 000000000..8c0b67fe3
Binary files /dev/null and b/apps/website/public/docs/roam/share-roam-export.png differ