106.9K+Download
Skip to the usage guide
Baoyu Markdown to HTMLby jimliu

Baoyu Markdown to HTML Skill.

Convert Markdown into styled HTML for article publishing.

  • Markdown
  • Article Styling
Download OpenDesignView Usage Guide
Source Review · baoyu-markdown-to-htmlSKILL.md
Task Convert Markdown into styled HTML for article publishing. Produces A themed HTML file with inline CSS. Before You Start The skill creates HTML; publishing the article is a separate action.
Editorial summary · source reviewed 2026-11-02 · not a generated example

01 What It Does

Convert Markdown into styled HTML for article publishing

Convert Markdown to themed inline-CSS HTML with code, diagrams and optional external-link citations for WeChat article workflows.

Source-based workflowNot an execution benchmark

The Working Approach

Baoyu Markdown to HTML converts an article into styled HTML with inline CSS, optimized for WeChat Official Account workflows. It supports theme and typography choices alongside code highlighting, footnotes, alerts and diagram content. The converted HTML is saved beside the Markdown source, and an existing HTML output receives a timestamped backup.

The skill also handles publishing details that affect the finished article. The first heading is removed by default unless keep-title is enabled, and external links become bottom citations only when explicitly requested. Mermaid diagrams are rendered through a browser to cached PNG assets, with a text fallback if rendering is unavailable.

Expected Deliverables

  • A themed HTML file with inline CSS.
  • Generated or referenced image information, including Mermaid PNG assets when rendering succeeds.
  • A structured result containing the HTML path and any backup path.
See the Example Brief

From Brief to Review

  1. 01
    Resolve the article presentation

    Read explicit theme choices and EXTEND.md preferences. If the input contains CJK text and baoyu-format-markdown is available, offer that separate formatting step before conversion.

  2. 02
    Choose citation and title behavior

    Keep external-link citations off unless requested. Decide whether the leading heading should remain in the article body.

  3. 03
    Convert content and diagrams

    Run the bundled main.ts converter through Bun or its documented npx fallback with the selected presentation options. Mermaid uses browser-based PNG rendering and a cache when available.

  4. 04
    Inspect the publishing output

    Open the HTML, check diagrams and report the result paths. Distinguish successfully generated images from fallback Mermaid markup.

02 When to Use It

When to Use It

The skill creates HTML; publishing the article is a separate action.

A Good Fit

  • Styled article exportsA Markdown article needs inline-CSS HTML for a publishing workflow.
  • WeChat formattingContent requires compatible themes and optionally collected external references.

Limits to Check

  • Conversion scopeThe skill creates HTML; publishing the article is a separate action.
  • Browser-dependent diagramsMermaid PNG rendering needs Chrome, Chromium or Edge.
  • Fallback successConversion can succeed while a diagram remains fallback markup, so inspect the result.

Bring These Inputs

  • Markdown sourceProvide the article and any local images it references.
  • Presentation choicesSelect a theme and optional color, font or title override.
  • Publishing behaviorSpecify citation mode, title retention and diagram needs.

03 Decisions That Matter

Decisions That Matter

  1. Article-ready styling

    Inline CSS carries the selected theme into the exported document.

  2. Explicit link handling

    Bottom citations are opt-in, with documented exceptions for WeChat and bare URLs.

  3. Recoverable output

    Existing HTML receives a timestamped backup before replacement.

04 Try a Focused Brief

Try a Focused Brief

The example brief below has not been tested. Check the skill’s setup before using it.

Review the Source and Setup

Provide the article and any local images it references.

Upstream Source File
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-markdown-to-html/SKILL.md

The reference below opens the upstream instructions. Review the repository setup before using them; it is not an installation command.

Start With One Deliverable

Adapt the scope, source material and constraints in this brief before running the skill.

Example Brief
Use baoyu-markdown-to-html to convert the supplied article with the simple theme and our chosen accent color. Preserve the first heading and enable bottom citations for ordinary external links. Keep the Markdown source unchanged. The article includes two Mermaid diagrams, so attempt PNG rendering and inspect whether the output contains usable images or fallback markup. Report the HTML path, any backup path and generated diagram assets. Do not publish the article. Flag unsupported formatting or missing local images that require attention before it enters the publishing workflow.

Inspect the Result

Check the actual output against these observable criteria.

  • The HTML reflects the requested theme and title behavior.
  • Diagrams are inspected rather than inferred from a successful conversion exit.
  • Output and backup paths are reported accurately.

OpenDesign provides a local design workspace for coding agents. This listing does not mean the skill is bundled or that its external tools, credentials and software dependencies are included.

Download OpenDesignRead the Quickstart

05 Source and License

Source and License

This page describes the pinned source revision linked below. Upstream behavior and requirements can change.

Source Owner
jimliu
Repository
jimliu/baoyu-skills
Skill File
SKILL.md
License
MIT
Reviewed Snapshot
2026-11-02 · 0a27d7d40e79

Reading Notes

  1. License ScopePinned repository LICENSE text verified; complete archive filename inventory found no more-specific LICENSE/COPYING/NOTICE file under this skill path. Classification is for the reviewed upstream source, not generated output or third-party dependencies. README specifies GitHub repository MIT unless otherwise noted, while published ClawHub distributions use MIT-0; this entry classifies the pinned GitHub source. Related converter code under packages/baoyu-md/src/LICENSE has a WTFPL Version 2 notice for code adapted from doocs/md. Do not label the entire dependency bundle as uniformly MIT.
Editorial Source Summary
Convert Markdown into styled HTML for article publishing.

Original summary by OpenDesign, based on the linked source. Repository stars are a dated popularity signal, not skill usage or a quality score.

06 Questions Before You Start

Questions Before You Start

Are external links always moved to the bottom?

No. Citation mode is off by default and enabled only on explicit request.

What happens if Mermaid rendering fails?

The converter can fall back to preformatted Mermaid markup while the overall conversion succeeds.

Does it replace an existing HTML file?

The source says it first creates a timestamped backup and reports its path.

OpenDesign

Keep Your Brief and Design Work Together.

Keep your brief, source material and design work together in a local workspace. Check the skill’s own setup before adding it to your workflow.

Download OpenDesignBrowse Design Skills
Upstream Source File
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-markdown-to-html/SKILL.md