Kit de Publication de Documentation
Scénario

Kit de Publication de Documentation

Rédigez, formatez et publiez des docs techniques en un seul flux.

3 compétences 7 installations
documentationmarkdownpublishinghtmlwriting
Mis à jour hier

Installer

Exécutez cette commande pour installer toutes les compétences de ce pack :

npx skillstore add @docs-publishing-kit

La CLI détecte automatiquement les dossiers Codex et Claude Code et installe la compétence dans les deux lorsqu’ils sont disponibles.

Aperçu

Guide d’utilisation

Amélioré par l’IA

Guide détaillé

## Présentation
Kit de Publication de Documentation vous offre un flux unique pour transformer des notes techniques brutes en documentation prête à publier : rédigez le contenu, nettoyez la structure markdown, puis exportez du HTML soigné à partager.

## Démarrage Rapide
1. Commencez par `documentation` quand vous avez besoin de rédiger ou remodeler des plans, propositions, spécifications, READMEs, notes, guides, ou autres sorties de documents markdown.
2. Exécutez `baoyu-format-markdown` sur le brouillon pour nettoyer le frontmatter, les titres, les résumés, les headings, le texte gras, les listes et les blocs de code. Il génère un fichier `{filename}-formatted.md` formaté.
3. Utilisez `baoyu-markdown-to-html` quand le markdown terminé nécessite une sortie HTML stylisée, incluant la prise en charge du surlignage de code, des maths, de PlantUML, des notes de bas de page, des alertes et du contenu adapté aux infographies.

## Commandes Clés
- `documentation` — Rédigez des documents structurés tels que des spécifications, READMEs, propositions, plans, notes, guides et fichiers markdown.
- `jimliu-baoyu-format-markdown` / `baoyu-format-markdown` — Formatez du texte brut ou du markdown dans une mise en page plus propre avec headings, listes, frontmatter et typographie.
- `jimliu-baoyu-markdown-to-html` / `baoyu-markdown-to-html` — Convertissez du markdown terminé en HTML stylisé pour la publication web ou de contenu riche.

## Conseils
- Gardez le flux séquentiel : rédigez avec `documentation`, polissez avec `baoyu-format-markdown`, puis publiez avec `baoyu-markdown-to-html`.
- Utilisez la sortie markdown formatée comme source unique avant la conversion HTML pour que README, spécification et page publiée restent alignés.
- Pour les docs techniques avec des diagrammes ou des maths, terminez d'abord le markdown, puis laissez `baoyu-markdown-to-html` gérer PlantUML, les maths, les notes de bas de page, les alertes et le surlignage de code dans l'export HTML.

Compétences

3