Introduction

When performing agent tasks in DeepSeek Harness (DSH), there is often a need to display Markdown content directly, such as research reports, meeting minutes, or course outlines. Existing approaches often involve manual layout or introducing additional front-end engineering. If the goal is simply to obtain a single-file HTML presentation that can be opened directly in a browser, a sufficiently lightweight tool plugin is required.

Below is an introduction to dsh-deck-builder. Maintained by Blaczz and licensed under the MIT License, it is a DSH tool plugin: it registers the deck_build tool to convert Markdown into a self-contained HTML presentation, supports themes and keyboard navigation, introduces no dependencies, and does not modify the DSH core.

What is it

dsh-deck-builder is positioned as a DSH tool plugin: input Markdown, output a single-file HTML presentation.

It registers the deck_build tool via ctx.tools.register. The generated result is self-contained: it uses inline CSS/JS, has no external resources, and does not access the network.

This plugin is an independent community plugin and is not officially affiliated with DeepSeek Harness.

Core Features

The deck_build tool accepts Markdown and returns the output path, the number of slides, and the byte count.

Supports three themes:

  • deepseek
  • light
  • dark

The splitting logic works as follows:

  1. Priority is given to ---, ***, or ___ separators.
  2. If none of these separators are present, it falls back to splitting by H1/H2 headers.

Markdown rendering covers:

  • Titles
  • Paragraphs
  • Ordered lists
  • Unordered lists
  • Code blocks
  • Blockquotes
  • Bold/Italic
  • Inline code
  • Links
  • Images

The implementation path is zero-dependency and zero-core-modification: it uses pure functions for generation, is registered via ctx.tools.register, does not use a client bundle, does not access the network, and introduces no external resources. The generation logic is covered by unit tests: splitting, rendering, escaping, and self-containment.

Installation and Usage

Prerequisites:

  • DSH is available and dsh web runs
  • Node ≥ 22.19
  • pnpm

Execute the following from GitHub installation:

dsh plugin --profile web add "github:Blaczz/dsh-deck-builder#main"

This step adds the plugin to the web profile. After installation, restart dsh web.

Optional peerDependencies:

@deepseek-ai/cordis >=4.0.1-rc.1 <5.0.0
@deepseek-ai/dsh-tools >=0.1.0-rc.3 <0.2.0

Typical Usage

In a DSH conversation, you can directly ask the agent to build a presentation, for example:

Turn this research report into slides using the deepseek theme:
<markdown content>

The agent will invoke deck_build to generate deck-<title>.html. After opening the file, you can use:

  • ← / → or the Spacebar to switch slides
  • f to enter fullscreen
  • Browser print or export to PDF, with one slide per page

Manual Tool Invocation

You can also invoke deck_build directly. Example fields are as follows:

{
  "markdown": "# Title\nbody\n\n---\n\n# Slide 2\nmore",
  "title": "My Deck",
  "theme": "deepseek",
  "outputPath": "slides/my-deck.html"
}

Where:

  • markdown: The presentation content
  • title: The presentation title
  • theme: The theme
  • outputPath: The output path

The tool returns the output path, the number of slides, and the byte count.

Use Cases and Notes

Suitable for the following situations:

  • Using in DSH web scenarios
  • Need to convert Markdown reports, meeting minutes, or course outlines into distributable single-file HTML slides
  • Desire for offline availability without external resources
  • Desire to avoid modifying the DSH core and only add a tool

Notes:

  • The plugin runs with the permissions of the current DSH process. Before installation, you should review the source code, license, and dependency scope.
  • This plugin is maintained by Blaczz and is licensed under MIT © 2026.
  • It is an independent community plugin and is not officially affiliated with DeepSeek Harness.
  • You need to restart dsh web after installation.

Links

GitHub repository: https://github.com/Blaczz/dsh-deck-builder

Plugin directory entry: https://www.skillhub.cn/plugins/Blaczz/dsh-deck-builder