Introduction

In DeepSeek Harness (DSH) web sessions, the common practice when clicking .md references is to jump to the system editor to view the source file. This leaves the current conversation context, making it inconvenient, especially when proofreading, editing, or comparing output results.

poiuyjie/dsh-md-preview addresses this workflow by placing the .md preview in the DSH sidebar side-by-side, instead of directly launching the system default editor. Below, we introduce its positioning, features, installation method, and typical usage.

What is this

dsh-md-preview is a Markdown preview plugin for DeepSeek Harness. The repository is poiuyjie/dsh-md-preview, maintained by poiuyjie, and licensed under MIT.

It solves a specific problem in DSH web sessions: when clicking .md references in the conversation, it previews the file in the sidebar side-by-side while recording the .md files accessed in this session.

According to package.json, the plugin declares node >=20.3. The plugin itself is pure JS with no build steps, and the client-side supports HMR.

Core Features

The core capabilities are as follows:

  • Right sidebar side-by-side preview of .md references, aligned with the top of the conversation content, with a draggable width.
  • Session-isolated list of recent .md files, recording files read/written/opened in the current session.
  • Supports both floating window and sidebar docking modes, with memory for position/size.
  • Holding Ctrl/Cmd/Shift and clicking .md references still opens them with the system default application.
  • Supports manually entering .md paths relative to the working directory to open previews.
  • Complete Markdown rendering: headings, lists, tables, code blocks, blockquotes, inline code, math fragments, image links.
  • Automatically switches with the DSH shell’s dark/light theme.
  • Provides “Conversation/Trajectory” tabs and a full-page “MD Preview” tab.
  • Can be paired with dsh-vision-opencode for visual verification and source draft preview workflows.

Installation and Enablement

First, confirm the DSH profile is web, then execute:

dsh plugin --profile web add github:poiuyjie/dsh-md-preview

This command is used to add the plugin. On Windows, replace dsh with dsh.ps1, or use:

powershell dsh.ps1

Installation Notes

It is recommended to use dsh plugin add for native installation. Do not simply use npm pkg set as a substitute: the latter does not download the package and does not register the plugin into the dsh.profile.bundles assembly layer.

If using the manual installation method, you need to enable the md-preview insert entry in the profile’s cordis.patch.yml:

- insert:
    - id: md-preview
      name: 'dsh-md-preview'

pnpm Notes

If the profile uses pnpm and adopts file: local dependencies, note that local dependencies are snapshot-copied to node_modules/.pnpm/. After modifying the source code, you need to run pnpm install again, or manually synchronize the modified files to the corresponding directory, then refresh the page.

Typical Usage

After the installation steps above, you can use it as follows after refreshing the page.

  1. Click the “MD Preview” button in the session header to open the panel.
  2. The panel defaults to showing cards of the .md files recently accessed in the current session, including filename, path, operation history, and summary.
  3. Click .md references in the conversation message stream, and the right sidebar will automatically open and load the file.
  4. Drag the left border divider to adjust the width; click “Float” to switch to a floating window; click the close button to collapse the panel.
  5. Hold Ctrl/Cmd/Shift and click .md references to open them with the system default application.
  6. You can also manually enter the .md path relative to the working directory to open the preview.

Pairing with dsh-vision-opencode

If you need to switch between visual verification and source draft preview, you can pair it with dsh-vision-opencode. The installation commands are as follows:

dsh plugin --profile web add github:poiuyjie/dsh-vision-opencode
dsh plugin --profile web add github:poiuyjie/dsh-md-preview

This combination is used for visual verification and source draft preview workflows: while viewing the rendered or verification results on one side, compare with the Markdown source draft on the right.

Uninstallation and Notes

Uninstalling the plugin only removes the preview panel functionality and does not delete .md files or session records.

The plugin runs with the permissions of the current dsh process. You should check the source code and license before installing. This plugin is licensed under MIT, and the repository address is:

https://github.com/poiuyjie/dsh-md-preview

Conclusion

If you hope to frequently view .md source drafts in DSH web sessions while maintaining the conversation context, the value of dsh-md-preview is quite direct: right-side side-by-side preview, session recent file list, automatic theme switching, and pairing with dsh-vision-opencode.

Directory page:

https://www.skillhub.cn/plugins/poiuyjie/dsh-md-preview

GitHub:

https://github.com/poiuyjie/dsh-md-preview