Spectral Docs

Éditeur Markdown pour la préparation et la publication de manuscrits

Démarrage rapide

1. Ouvrez Preparo dans votre navigateur
2. Créez un nouveau projet (livre ou article)
3. Importez un document ou commencez à écrire dans l’éditeur
4. Structurez votre manuscrit en chapitres
5. Configurez les métadonnées et exportez en EPUB, DOCX ou PDF

Interface

Preparo utilise une disposition en trois panneaux :

Types de projets

Importer des documents

Cliquez sur le bouton Importer dans le panneau Documents pour convertir des fichiers en Markdown :

• Formats supportés : DOCX, EPUB, PDF, HTML, ODT, LaTeX, et plus
• Les fichiers sont convertis via Pandoc et stockés localement
• Après l’import, utilisez Scinder par H1 (✂) pour séparer un document volumineux en chapitres individuels

Chaque chapitre issu de la scission reçoit uniquement les notes de bas de page qu’il référence, avec renumérotation automatique.

L’éditeur

Preparo dispose d’un éditeur Markdown WYSIWYG basé sur Milkdown, avec un support complet du Markdown Pandoc.

Barre d’outils

La barre d’outils offre un accès rapide au formatage :

• Texte : Gras, italique, souligné, barré, exposant, petites capitales
• Structure : Titres (H1–H6), citations, listes à puces et numérotées
• Insertion : Images, notes de bas de page, citations bibliographiques, bloc bibliographie
• Code : Code en ligne, blocs de code

Notes de bas de page

Insérez des notes de bas de page avec le bouton de la barre d’outils. Preparo gère la numérotation automatiquement :

• Les appels de note sont insérés à la position du curseur
• Les définitions sont ajoutées à la fin du document
• La numérotation se met à jour automatiquement lors de l’ajout ou la suppression de notes

Navigateur

Le panneau Navigateur (dans la barre latérale de l’éditeur) propose trois onglets :

• TDM — Table des matières générée à partir des titres
• Blocs — Vue d’ensemble de la structure du document (titres, paragraphes, listes, images)
• Styles — Styles de formatage actifs à la position du curseur

Extensions Pandoc

L’éditeur supporte la syntaxe Markdown spécifique à Pandoc :

• Spans entre crochets : [texte]{.classe #id clé="valeur"}
• Divs délimités : blocs ::: {.classe}
• Exposant : ^exposant^
• Attributs de titres : # Titre {#id .classe epub:type=chapter}
• Typographie intelligente : Guillemets courbes, tirets cadratins, points de suspension automatiques

Types de documents

Chaque document d’un projet livre peut se voir attribuer un type correspondant à la sémantique structurelle EPUB :

Pages liminaires (frontmatter)

Préface, avant-propos, introduction, page de titre, page de copyright, dédicace, table des matières, etc.

Corps du texte (bodymatter)

Chapitres, parties.

Annexes (backmatter)

Bibliographie, annexe, postface, glossaire, index, etc.

Les types de documents servent à :

• Générer des noms de fichiers structurés pour l’export (ex. : 00-preface.md, 02-chapitre-1.md)
• Appliquer automatiquement les attributs epub:type pour la conformité EPUB
• Ordonner correctement les documents dans le manuscrit exporté

Bibliographie et citations

Preparo s’intègre à Zotero pour la gestion bibliographique lorsqu’il est connecté à Spectral Cloud.

Connexion à Zotero

1. Connectez-vous via le portail Spectral Cloud
2. Enregistrez votre clé API Zotero dans les paramètres du portail
3. Associez une collection Zotero à votre projet

Travailler avec les citations

• Ouvrez le panneau Bibliographie pour parcourir vos références
• Double-cliquez sur un élément pour insérer une citation ([@cléref]) à la position du curseur
• Les citations s’affichent sous forme de badges formatés dans l’éditeur (style Chicago Author-Date)
• Cliquez sur un badge de citation pour modifier ses champs (titre, auteurs, date, etc.)

Bloc bibliographie

Insérez un champ {{bibliography}} pour afficher une bibliographie dynamique dans votre document. La bibliographie rassemble toutes les références citées dans l’ensemble des documents du projet.

Synchronisation

• Les modifications locales des références sont automatiquement poussées vers Zotero
• Les modifications distantes sont récupérées toutes les 60 secondes
• La résolution des conflits est basée sur les horodatages de modification
• Le formatage des citations inter-chapitres (ibid., op. cit.) est entièrement pris en charge

Configuration du projet

Ouvrez le panneau de configuration du projet pour gérer les métadonnées et les paramètres d’export.

Métadonnées (YAML)

Les métadonnées du livre sont stockées en YAML et transmises à Pandoc lors de l’export :

title: "Titre de mon livre"
author: "Nom de l'auteur"
lang: fr
publisher: "Éditeur"
isbn-print: "978-..."
rights: "© 2026 Nom de l'auteur"

Paramètres EPUB

Export

Preparo prend en charge plusieurs formats d’export depuis le panneau Documents.

EPUB

• EPUB 2 et EPUB 3 sont exportés via des boutons distincts
• Les chapitres sont assemblés dans l’ordre défini par les types de documents et leur position
• Les images, polices et feuilles de style CSS sont intégrées automatiquement
• Le champ {{bibliography}} est résolu avant l’export
• Si un document de page de titre existe, la page de titre auto-générée par Pandoc est désactivée

Autres formats

Les exports multi-chapitres utilisent --file-scope pour isoler la numérotation des notes par chapitre.

Gabarits

Téléchargez des feuilles de style CSS et des styles de citation CSL dans l’onglet Gabarits du panneau Documents. Les gabarits sont automatiquement filtrés par version EPUB lors de l’export.

Sauvegarde automatique

Preparo sauvegarde automatiquement votre travail dans le stockage local du navigateur (IndexedDB) :

• Les modifications sont enregistrées après un court délai (1 seconde par défaut)
• Un indicateur d’état affiche l’état actuel : en cours, sauvegardé ou erreur
• Utilisez Export/Import dans les paramètres du projet pour sauvegarder vos données

Markdown supporté

L’éditeur prend en charge la syntaxe Markdown suivante :

• # Titre 1 jusqu’à ###### Titre 6
• **gras**, *italique*, ***gras italique***
• ~~barré~~, ^exposant^
• [souligné]{.underline}, [petites capitales]{.smallcaps}
• > citation
• - liste à puces, 1. liste numérotée
• ![alt](image.jpg) — images avec légendes
• | tableau | syntaxe | — tableaux Markdown
• [^1]: note — notes de bas de page avec numérotation automatique
• [@cléref] — citations Pandoc
• [texte]{.classe} — spans entre crochets
• ::: {.classe} — divs délimités
• # Titre {#id .classe epub:type=chapter} — attributs de titres

Preparo — Spectral Lab