Dockable Markdown preview for the DSH Web UI: side-by-side with the conversation, a per-session recently-read .md list, local relative-path images render in place, and clicking an in-chat .md reference previews it instead of launching the system editor; follows the shell light/dark theme.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:poiuyjie/dsh-md-preview
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
dsh-md-preview
A Markdown preview plugin for DeepSeek Harness
Click a
.mdin your conversation — no more jumping to VSCode. Open a side-by-side preview on the right and read on.
⚡ Core experience — side-by-side with your conversation: keep chatting, writing and proofreading on the left while the .md source you clicked renders live, side-by-side in the same window on the right — what you see is what you wrote, no window switching; dark/light theme follows the shell automatically.
A DeepSeek Harness (DSH) plugin that adds an MD Preview entry to the session header, tracks the .md files your session has read or written, and opens an in-chat .md reference side-by-side in the right panel instead of launching the system editor (e.g. VSCode).
Built with dsh-vision-opencode
This plugin pairs with dsh-vision-opencode — and was developed and polished on top of that vision plugin. Together they make a much stronger workflow:
- Visual-verification loop:
dsh-vision-opencodegives a text-only main model image understanding (vision_read_image), so the model can "see" rendered document pages; this plugin then opens the corresponding.mdsource side-by-side on the right — look at the rendered image, compare against the source, revise, verify, and record in one flow - Image-to-source comparison: the left conversation stream holds the visual verdicts ("Table III renders cleanly, no overflow"), while the right panel holds the Markdown source — review and edit side by side
- Great for document / paper workflows: LaTeX build checks, layout QA, revision records — visual confirmation plus source preview in split view
Install them together (prefer the native DSH plugin commands: they download the sources from GitHub, register the packages into the profile's dsh.profile.bundles layer and apply each cordis.patch.yml automatically — hand-editing package.json with npm pkg set neither downloads anything nor registers the layer, so the plugin won't take effect):
dsh plugin --profile web add github:poiuyjie/dsh-vision-opencode
dsh plugin --profile web add github:poiuyjie/dsh-md-preview
💡 On Windows use
dsh.ps1instead ofdsh(orpowershell dsh.ps1); the profile directory is%USERPROFILE%\.dsh\profiles\web.
Features
- Side-by-side preview: click a
.mdreference in the conversation (produced-file chips / inline references / tool-card paths) to open it in the right panel — top-aligned with the conversation content, draggable width (up to about half the screen), layout yields automatically without covering the chat - Per-session recent list: automatically collects the
.mdfiles your session read/wrote (read/write/edit/delete + time + file mtime); each session only sees files it actually touched — no cross-session leakage - Two display modes:
- Floating window: draggable, resizable, position/size remembered (localStorage)
- Docked right panel: side-by-side with the conversation, drag the left divider to resize
- Modifier-key escape hatch: hold Ctrl/Cmd/Shift while clicking a
.mdreference to open it with the system default app (VSCode) instead - Manual open: type a workspace-relative
.mdpath to preview it - Full Markdown rendering: headings / lists / tables / code blocks / quotes / inline code / math snippets / image links
- Full-page tab: also available as a "MD Preview" tab in the Conversation/Trajectory bar
System support
⚠️ Prefer the native
dsh plugininstall (dshon Linux/macOS,dsh.ps1on Windows). The manual route (clone +npm install+ editcordis.patch.yml) has been verified on Ubuntu (DSH0.1.0-rc.6) and Windows; on other distros the install paths, the~/.dshprofile directory, and thecordis.patch.ymlsyntax may differ — adapt to your environment.
Installation
Option 0: dsh plugin add (native, recommended)
The package declares a dsh.bundle manifest and ships its own cordis.patch.yml, so it installs with the native plugin command (auto-applied as a profile layer — no manual cordis.patch.yml edits needed):
dsh plugin --profile web add github:poiuyjie/dsh-md-preview
⚠️ Don't substitute
npm pkg set "dependencies.xxx=...": it only edits one field ofpackage.json— it neither downloads the package nor registers it into thedsh.profile.bundleslayer, sodsh webwon't pick it up.dsh plugin adddoes both (download + register the layer, applyingcordis.patch.ymlfor you).
Option 1: Clone locally (recommended — easy to edit and to follow updates)
Clone from GitHub (example: ~/plugins):
mkdir -p ~/plugins && cd ~/plugins
git clone https://github.com/poiuyjie/dsh-md-preview.git
cd dsh-md-preview
Then reference the local path from your DSH web profile (Ubuntu: ~/.dsh/profiles/web):
cd ~/.dsh/profiles/web
npm pkg set "dependencies.dsh-md-preview=file:~/plugins/dsh-md-preview"
npm install
Option 2: Reference GitHub directly (no clone, quick)
cd ~/.dsh/profiles/web
npm pkg set "dependencies.dsh-md-preview=github:poiuyjie/dsh-md-preview"
npm install
Enable the plugin manually (Option 1 / Option 2 only — dsh plugin add does this automatically)
Add an entry to the profile's cordis.patch.yml:
- insert:
- id: md-preview
name: 'dsh-md-preview'
Restart dsh web and refresh the page — you'll see the MD Preview button in the session header.
Tip: with Option 1,
git pullin the cloned repo follows updates; the plugin is plain JS with no build step — after editing code, a page refresh is enough for the client half (HMR supported).
Uninstall
From the profile directory (Ubuntu: ~/.dsh/profiles/web):
cd ~/.dsh/profiles/web
npm pkg delete dependencies.dsh-md-preview
npm install
(If you installed via Option 1, the dependency is removed automatically; for a full cleanup also run rm -rf ~/plugins/dsh-md-preview.)
Then remove the insert entry from cordis.patch.yml:
# Remove this block:
- insert:
- id: md-preview
name: 'dsh-md-preview'
Finally restart dsh web. Uninstalling never deletes your .md files or session history — it only removes the preview panel.
Usage
- Click the MD Preview button in the session header to open the panel;
- The panel shows your session's recently accessed
.mdfiles (name / path / op history / snippet); - Click a
.mdreference in the message stream → the right panel opens and loads that file automatically; - Drag the divider on the panel's left edge to resize; click "浮动" (Float) to switch to a floating window; click "✕" to close;
- Hold Ctrl/Cmd/Shift while clicking a reference → opens with your system default editor.
Development
# The plugin itself (Host half + Client half, plain JS, no build step)
ls index.js client.js
index.js— Host half. Listens tofs/observedto record md file access (isolated per session), serves/md-preview/api/{recent,read,peek}HTTP endpointsclient.js— Client half. Panel UI, click interception (capture-phase detection of md reference buttons), right-dock + layout yielding
License
Links
More in this category
tt-a1i/archify#integrations/deepseek-harness★ 97198
Generate validated, self-contained interactive architecture, workflow, sequence, data-flow, and lifecycle diagrams from repositories or system descriptions.
Roland0511/dsh-marktext★ 742
WYSIWYG Markdown editor in the DSH right sidebar, built on MarkText's muya engine: open a .md file, edit it as a rendered document, and save back through ctx.fs with a version guard.
dream-num/dsh-univer-office★ 729
Give DeepSeek Harness a real office environment. Univer Office Plugin brings spreadsheets, docs, slides, canvases, relational tables, and more into one runtime — with connected data, validation, versioned changes, and isolated worktrees for multi-agent collaboration.
ECNU/EduWork#dsh-knowledge-studio★ 370
A workspace-based Studio for source-grounded reports, slides, tables, mind maps, quizzes, flashcards, audio and video, using DSH models and shared artifact services. Office generation requires Python 3.12+ with its dependencies and DSH_OFFICE_PYTHON configured; media rendering requires Chromium, and local ASR additionally requires whisper.cpp and a model.
PerryLink/dsh-industry-research★ 219
Deterministic industry research reports for DeepSeek Harness — company and industry research flows produce structured, verifiable reports from staged evidence.
joeseesun/qiaomu-ui-learn-dsh★ 84
Browse UI design references and interaction examples, take design quizzes, and export learning notes as Markdown.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.