Aller au guide d’utilisation
Baoyu Markdown to HTMLpar jimliu

Baoyu Markdown to HTML Skill.

Convertissez Markdown en HTML mis en forme pour publier des articles.

  • Markdown
  • Mise en forme d’articles
Analyse de la source · baoyu-markdown-to-htmlSKILL.md
Tâche Convertissez Markdown en HTML mis en forme pour publier des articles. Résultats Un fichier HTML avec le thème choisi et du CSS intégré aux éléments. Avant de commencer Le Skill crée du HTML ; publier l’article est une action distincte.
Synthèse éditoriale · source examinée le 2026-11-02 · pas un exemple généré

01 Fonctionnement

Convertir Markdown en HTML mis en forme pour publier des articles

Convertissez Markdown en HTML avec thème et CSS intégré, code, diagrammes et citations facultatives des liens externes pour les articles WeChat.

Flux de travail fondé sur la sourcePas un benchmark d'exécution

La méthode de travail

Baoyu Markdown to HTML convertit un article en HTML avec du CSS intégré aux éléments, optimisé pour les workflows WeChat Official Account. Il propose des choix de thème et de typographie, la coloration du code, les notes de bas de page, les encadrés d’alerte et les diagrammes. Le HTML converti est enregistré à côté de la source Markdown ; une sortie HTML existante reçoit une sauvegarde horodatée.

Le Skill traite aussi les détails de publication qui influent sur l’article final. Le premier titre est supprimé par défaut, sauf si keep-title est activé. Les liens externes ne deviennent des citations en fin d’article que sur demande explicite. Les diagrammes Mermaid sont rendus par un navigateur en images PNG mises en cache, avec un repli textuel si le rendu est indisponible.

Livrables attendus

  • Un fichier HTML avec le thème choisi et du CSS intégré aux éléments.
  • Des informations sur les images générées ou référencées, notamment les PNG Mermaid lorsque le rendu réussit.
  • Un résultat structuré contenant le chemin du HTML et l’éventuel chemin de sauvegarde.
Voir l'exemple de brief

Du brief à la revue

  1. 01
    Définir la présentation de l’article

    Lisez les choix explicites de thème et les préférences EXTEND.md. Si le contenu comporte du texte CJK et que baoyu-format-markdown est disponible, proposez cette étape distincte de mise en forme avant la conversion.

  2. 02
    Choisir le traitement des citations et du titre

    Laissez les citations de liens externes désactivées sauf demande. Décidez si le titre initial doit rester dans le corps de l’article.

  3. 03
    Convertir le contenu et les diagrammes

    Exécutez le convertisseur main.ts fourni via Bun ou sa solution de repli npx documentée, avec les options de présentation retenues. Mermaid utilise un rendu PNG par navigateur et un cache lorsque c’est possible.

  4. 04
    Examiner la sortie destinée à la publication

    Ouvrez le HTML, vérifiez les diagrammes et indiquez les chemins obtenus. Distinguez les images générées avec succès du balisage Mermaid de repli.

02 Cas d’usage

Quand l’utiliser

Le Skill crée du HTML ; publier l’article est une action distincte.

Un bon choix

  • Exporter des articles mis en formeUn article Markdown nécessite du HTML avec CSS intégré aux éléments pour un workflow de publication.
  • Mise en forme WeChatLe contenu nécessite des thèmes compatibles et, éventuellement, des références externes regroupées.

Limites à vérifier

  • Périmètre de conversionLe Skill crée du HTML ; publier l’article est une action distincte.
  • Diagrammes dépendants du navigateurLe rendu PNG de Mermaid nécessite Chrome, Chromium ou Edge.
  • Une conversion réussie peut utiliser un repliLa conversion peut réussir alors qu’un diagramme reste sous forme de balisage de repli : inspectez donc le résultat.

Éléments à fournir

  • Source MarkdownFournissez l’article et les images locales qu’il référence.
  • Choix de présentationSélectionnez un thème et, si nécessaire, personnalisez la couleur, la police ou le titre.
  • Comportement de publicationPrécisez le mode de citation, la conservation du titre et les besoins en diagrammes.

03 Décisions importantes

Les décisions importantes

  1. Des styles adaptés aux articles

    Le CSS intégré aux éléments transmet le thème choisi au document exporté.

  2. Un traitement explicite des liens

    Les citations en fin d’article doivent être activées explicitement, avec des exceptions documentées pour WeChat et les URL brutes.

  3. Une sortie récupérable

    Le HTML existant reçoit une sauvegarde horodatée avant son remplacement.

04 Exemple de brief

Essayez un brief ciblé

L'exemple de brief ci-dessous n'a pas été testé. Vérifiez la configuration du skill avant de l'utiliser.

Examiner la source et la configuration

Fournissez l’article et les images locales qu’il référence.

Fichier source amont
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-markdown-to-html/SKILL.md

La référence ci-dessous ouvre les instructions d’origine. Consultez la configuration du dépôt avant de les utiliser ; ce n’est pas une commande d’installation.

Commencer par un seul livrable

Adaptez le périmètre, les sources et les contraintes de ce brief avant d’exécuter le skill.

Exemple de brief
Utilise baoyu-markdown-to-html pour convertir l’article fourni avec le thème simple et notre couleur d’accent. Conserve le premier titre et active les citations en fin d’article pour les liens externes ordinaires. Ne modifie pas la source Markdown. L’article comporte deux diagrammes Mermaid : tente un rendu PNG et vérifie si la sortie contient des images utilisables ou du balisage de repli. Indique le chemin HTML, l’éventuel chemin de sauvegarde et les fichiers de diagrammes générés. Ne publie pas l’article. Signale les mises en forme non prises en charge ou les images locales manquantes à traiter avant son entrée dans le workflow de publication.

Inspecter le résultat

Comparez le résultat réel à ces critères observables.

  • Le HTML respecte le thème demandé et le traitement du titre.
  • Les diagrammes sont inspectés : leur réussite n’est pas déduite du seul succès de la conversion.
  • Les chemins de sortie et de sauvegarde sont indiqués avec exactitude.

OpenDesign fournit un espace de travail de design local pour les agents de code. Cette fiche ne signifie pas que le skill est fourni avec ses outils externes, ses identifiants et ses dépendances logicielles.

05 Source et licence

Source et licence

Cette page décrit la révision source figée liée ci-dessous. Le comportement et les exigences en amont peuvent changer.

Propriétaire de la source
jimliu
Fichier du skill
SKILL.md
Licence
MIT
Version examinée
2026-11-02 · 0a27d7d40e79

Notes de lecture

  1. Portée de la licenceLe texte LICENSE du dépôt a été vérifié pour la révision fixée ; l’inventaire complet des noms de fichiers de l’archive n’a révélé aucun fichier LICENSE/COPYING/NOTICE plus spécifique sous le chemin de ce Skill. La classification concerne la source d’origine examinée, pas les résultats générés ni les dépendances tierces. Le README indique que le dépôt GitHub est sous MIT sauf mention contraire, tandis que les distributions publiées sur ClawHub utilisent MIT-0 ; cette entrée classe la source GitHub à la révision fixée. Le code associé du convertisseur contient, dans packages/baoyu-md/src/LICENSE, une mention WTFPL Version 2 pour le code adapté de doocs/md. Ne présentez pas l’ensemble des dépendances comme uniformément sous MIT.
Résumé éditorial de la source
Convertissez Markdown en HTML mis en forme pour publier des articles.

Résumé original de OpenDesign, fondé sur la source liée. Les étoiles du dépôt sont un indicateur de popularité daté, pas une mesure d'utilisation du skill ni une note de qualité.

06 Questions avant de commencer

Questions avant de commencer

Les liens externes sont-ils toujours déplacés en fin d’article ?

Non. Le mode de citation est désactivé par défaut et activé uniquement sur demande explicite.

Que se passe-t-il si le rendu Mermaid échoue ?

Le convertisseur peut revenir à du balisage Mermaid préformaté tout en terminant la conversion globale avec succès.

Remplace-t-il un fichier HTML existant ?

La source indique qu’il crée d’abord une sauvegarde horodatée et en fournit le chemin.

OpenDesign

Gardez votre brief et votre travail de design au même endroit.

Gardez votre brief, vos sources et votre travail de design ensemble dans un espace de travail local. Vérifiez la configuration propre au skill avant de l'ajouter à votre flux de travail.

Fichier source amont
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-markdown-to-html/SKILL.md