Aide — comment utiliser docme

1. Fournir le document

Coller votre Markdown (ou HTML) dans la zone de texte ; ou
Uploader un fichier .md ou .html — il remplace alors le texte, et son type est déduit de l'extension.

2. Choisir le format de sortie

Format	Résultat
PDF (A4)	Document paginé A4, thémé — Markdown ou HTML.
Diaporama PDF (16:9)	Une diapo par page ; séparez les diapos par une ligne `---`.
PowerPoint (PPTX)	Présentation éditable ; attend du Markdown (les titres `##` ouvrent les diapos).
Aperçu HTML	Affiche le document thémé dans le navigateur (sans téléchargement).

3. Choisir un thème — palette.amia.fr

Les thèmes proposés (hadhinat, carbon, dark…) sont dérivés de palette.amia.fr — le Palette Studio, la source unique des palettes de l'écosystème @mostajs/*. Chaque palette y est composée à partir de quelques couleurs de marque, puis toutes les couleurs utiles sont dérivées et validées pour le contraste (WCAG) : aucune couleur illisible n'est produite (l'accent ne porte jamais de texte).

Pour ajouter ou ajuster un thème : composez-le sur palette.amia.fr (aperçus PC/mobile, table de contrastes), récupérez ses couleurs de marque, puis ajoutez son entrée au magasin @mostajs/palette (GALLERY). docme le proposera automatiquement.

Le thème s'applique au PDF et à l'aperçu HTML. Le PPTX suit un gabarit PowerPoint (pas le CSS).

4. Sans navigateur — la même conversion en ligne de commande

Ce site est une interface. Le convertisseur, lui, est un module qui s'installe :

npm i -g @mostajs/doc-export

doc-export rapport.md -o rapport.pdf            # PDF A4 thémé
doc-export cours.md -f slides-pdf -t carbon     # diaporama 16:9
cat doc.md | doc-export -f html -o -            # dans un tuyau
doc-export --capacites                          # ce qui est disponible ici

Même cœur, donc même document : cette page et cette commande appellent le même @mostajs/doc-export. La commande sert ce qu'un navigateur ne sait pas faire — un dossier entier d'un coup, une intégration continue, un poste sans réseau.

⚠ Une seule différence, et elle est voulue. Ce site interroge le Studio en direct ; la commande lit la galerie embarquée dans @mostajs/palette. Un thème retouché ce matin paraît ici tout de suite, et en ligne de commande après mise à jour du module. Le texte est le même ; les couleurs peuvent être d'un jour d'écart.

⚠ PDF ⇒ Chrome/Chromium, PPTX ⇒ pandoc. Absents, la commande le dit et s'arrête : elle ne rend jamais un document dégradé en silence.

Astuces

--- = saut de diapo (mode diaporama).
Saut de page en PDF : mettez-le sur le titre — <h2 style="page-break-before: always;">Titre</h2> — jamais un <div> vide.
L'arabe est détecté et rendu en RTL automatiquement. Les URL nues deviennent cliquables.

Confidentialité

Les documents sont convertis sur ce serveur souverain (PDF par Chrome/Chromium, PPTX par pandoc) : rien n'est envoyé à un service tiers.