From 0ce2334b644b4a379e86ac4d9082ab1f54680ae4 Mon Sep 17 00:00:00 2001
From: mirivlad <mirvtop@yandex.ru>
Date: Sat, 27 Jun 2026 23:47:11 +0800
Subject: [PATCH] Document Markdown preview implementation

---
 05_Official_Plugins.md            | 10 +++++++---
 07_Full_Implementation_Roadmap.md | 11 ++++++-----
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/05_Official_Plugins.md b/05_Official_Plugins.md
index df2818a..d006018 100644
--- a/05_Official_Plugins.md
+++ b/05_Official_Plugins.md
@@ -111,9 +111,10 @@ preview.markdown
 
 Назначение:
 
-- безопасный markdown render;
-- internal `verstak://` links;
-- optional syntax highlight.
+- read-only markdown render through a Workbench `openProviders` contribution;
+- `mode: "view"` support so edit routing remains with editor plugins;
+- safe baseline markdown rendering before optional syntax highlight/link
+  resolver integration.
 
 Provides:
 
@@ -128,6 +129,9 @@ Optional requires:
 link.resolver
 ```
 
+Текущий статус: базовый `verstak.markdown-preview` implemented as an official
+view-only provider for `.md` / `.markdown` files.
+
 ## 5. `official.file-preview`
 
 Назначение:
diff --git a/07_Full_Implementation_Roadmap.md b/07_Full_Implementation_Roadmap.md
index 7001447..ed67f9c 100644
--- a/07_Full_Implementation_Roadmap.md
+++ b/07_Full_Implementation_Roadmap.md
@@ -35,8 +35,9 @@ Implemented:
 - workspace top-level folder model and workspace item host;
 - Files Core text API with safe path policy and sync operation recording;
 - public `files.openExternal` / `files.showInFolder` API and Files plugin usage;
-- Workbench open/edit provider routing and default editor plugin;
-- official Files plugin, Notes plugin, Sync plugin, and platform-test plugin;
+- mode-aware Workbench open/edit provider routing and default editor plugin;
+- official Files plugin, Notes plugin, Markdown Preview plugin, Sync plugin, and
+  platform-test plugin;
 - browser inbox local receiver and minimal official Browser Inbox plugin;
 - sync server with device/user auth and operation push/pull;
 - SDK manifest/types/schema coverage for current plugin APIs;
@@ -49,8 +50,8 @@ Known remaining gaps:
 - Sidecar host is not implemented.
 - Files/Notes are usable but not complete: restore, binary streaming, watcher,
   richer conflict UX, and Notes trash/delete UX are still incomplete.
-- Markdown/file preview, activity, journal, browser inbox receiver/plugin, search, secrets, and
-  templates plugins are not complete product features.
+- File/image preview, activity, journal, browser inbox conversion workflow,
+  search, secrets, and templates plugins are not complete product features.
 - Browser extension repository has protocol, queue, and Chromium/Firefox build
   scaffold; desktop has a local receiver and mounted-view inbox plugin, but no
   pairing model, domain binding, or conversion workflow yet.
@@ -124,7 +125,7 @@ Goal: add the next visible product layer as replaceable plugins.
 
 Tasks:
 
-- implement `verstak.markdown-preview` provider plugin;
+- [x] implement `verstak.markdown-preview` provider plugin;
 - implement basic file/image preview plugin;
 - implement search provider/index contract and official search plugin;
 - implement activity event log plugin;