Ce document est un Working Draft publié le 26 septembre 2026. Il décrit l'état des formats tels qu'ils sont effectivement implémentés dans les applications ProAppli à cette date. Les parties marquées comme non stabilisées peuvent changer sans préavis avant la version 1.0.

This document is a Working Draft published on 26 September 2026. It describes the formats as they are actually implemented in the ProAppli applications at that date. Parts marked as not yet stabilised may change without notice before version 1.0.

Publier ce document en Working Draft est un appel à commentaires : toute personne souhaitant implémenter ces formats, signaler une ambiguïté ou proposer une évolution est invitée à écrire à info@netvincennes.fr.

Publishing this document as a Working Draft is a call for comments: anyone wishing to implement these formats, report an ambiguity or propose a change is invited to write to info@netvincennes.fr.

Les mots-clés doit, ne doit pas, devrait, ne devrait pas et peut employés dans ce document sont à interpréter au sens de RFC 2119 (respectivement MUST, MUST NOT, SHOULD, SHOULD NOT, MAY).

The keywords must, must not, should, should not and may in this document are to be interpreted as described in RFC 2119.

Exigences généralesGeneral requirements

• Un fichier PAOFF doit être encodé en UTF-8, sans BOM.
• Un fichier PAOFF doit rester un document Markdown valide au sens de CommonMark : tout ce que cette spécification ajoute doit se dégrader en contenu Markdown lisible dans un lecteur qui l'ignore.
• Le front matter, s'il est présent, doit être délimité par une ligne --- en tout début de fichier et une ligne --- de fermeture.
• Une implémentation doit ignorer silencieusement les clés de front matter qu'elle ne reconnaît pas, et ne doit pas les supprimer lors d'une réécriture du fichier.
• Une implémentation devrait préserver le contenu qu'elle ne sait pas rendre, plutôt que de l'écarter.
• L'extension de fichier (.doc.md, .table.md, .pres.md) devrait refléter le type de contenu ; une implémentation peut se fonder sur la clé type du front matter lorsque l'extension est simplement .md.

• A PAOFF file must be encoded in UTF-8, without BOM.
• A PAOFF file must remain a valid Markdown document per CommonMark: everything this specification adds must degrade into readable Markdown content in a reader that ignores it.
• The front matter, when present, must be delimited by a --- line at the very start of the file and a closing --- line.
• An implementation must silently ignore front matter keys it does not recognise, and must not drop them when rewriting the file.
• An implementation should preserve content it cannot render, rather than discarding it.
• The file extension (.doc.md, .table.md, .pres.md) should reflect the content type; an implementation may rely on the front matter type key when the extension is plain .md.

Les formats propriétaires binaires (.docx, .xlsx, .pptx) ont été conçus pour l'impression dans les années 90. Ils stockent les données dans des archives ZIP opaques, illisibles sans un logiciel spécifique. Les formats PAOFF sont du Markdown pur — du texte UTF-8, avec un en-tête YAML optionnel pour les métadonnées.

Proprietary binary formats (.docx, .xlsx, .pptx) were designed for printing in the 1990s. They store data in opaque ZIP archives, unreadable without specific software. PAOFF formats are plain Markdown — UTF-8 text, with an optional YAML header for metadata.

2.1 Pourquoi le texte brutWhy plain text

2.2 Le test de l'affichageThe rendering test

Pour afficher un fichier dans un navigateur ou une web app, voici ce que chaque format nécessite :

To display a file in a browser or a web app, here is what each format requires:

2.3 Structure communeCommon structure

Les trois formats PAOFF partagent la même structure : un front matter YAML délimité par ---, suivi du contenu Markdown standard. La clé type du front matter détermine comment le fichier est interprété.

The three PAOFF formats share the same structure: a YAML front matter delimited by ---, followed by standard Markdown content. The front matter type key determines how the file is interpreted.

Document texte enrichi en Markdown, avec prise en charge des inclusions de tableaux et de quiz via la syntaxe de transclusion (§ 7) et d'une structure de présentation via des blocs ```slide (§ 3.2).

A rich text document in Markdown, supporting table and quiz inclusions through the transclusion syntax (§ 7) and a presentation structure through ```slide blocks (§ 3.2).

ExempleExample

---
title: Rapport annuel 2025
author: Marie Dupont
date: 2025-12-01
type: document
---

# Introduction

Le bilan de l'exercice 2025 confirme une croissance de **12 %**.

## Résultats par région

![[resultats-regions.table.md]]

## Évaluation des connaissances

![[quiz-bilan.table.md]]

---
title: Annual Report 2025
author: Jane Smith
date: 2025-12-01
type: document
---

# Introduction

The 2025 fiscal year results confirm **12%** growth.

## Results by Region

![[regional-results.table.md]]

## Knowledge Assessment

![[assessment-quiz.table.md]]

3.1 Front matter — clés reconnuesFront matter — recognised keys

3.2 Mode hybride — blocs ```slide Hybrid mode — ```slide blocks

Un .doc.md peut contenir des blocs ```slide ... ``` pour être utilisé à la fois comme document et comme présentation. Le texte situé hors d'un bloc ```slide doit être ignoré lors du rendu en mode présentation. Le contenu d'un bloc ```slide n'est pas libre : c'est lui qui détermine la disposition, automatiquement, d'après ce qu'il contient (§ 3.2). Un bloc peut donc contenir un titre ##, une liste à puces, des paragraphes, une image, ou seulement un titre et une image.

A .doc.md file may contain ```slide ... ``` blocks so that it can serve both as a document and as a presentation. Text outside a ```slide block must be ignored when rendering in presentation mode. The content of a ```slide block is not free-form: it determines the layout, automatically, from what it contains (§ 3.2). A block may therefore hold a ## heading, a bulleted list, paragraphs, an image, or nothing but a heading and an image.

3.2.1 Dispositions automatiques d'une diapositive Automatic slide layouts

Un moteur de rendu doit déterminer la disposition d'une diapositive à partir de son seul contenu, sans marqueur ni attribut. Quatre compositions sont définies ; toute autre combinaison de titre, d'image et de texte tombe sur la composition « image à côté ».

A rendering engine must determine a slide's layout from its content alone, with no marker and no attribute. Four compositions are defined; any other combination of heading, image and text falls back to the image-on-the-side layout.

Une légende placée sous l'image compte comme du texte : une diapositive « titre + image + légende » doit donc être composée comme une image à côté. Une disposition peut aussi être demandée explicitement par l'auteur ; cette forme étant réservée et non normalisée (§ 3.3.1), un rendu peut l'ignorer sans erreur et appliquer la déduction.

A caption placed under the image counts as text: a “heading + image + caption” slide must therefore be laid out as image-on-the-side. An author may may also request a layout explicitly; since that form is reserved and not standardised (§ 3.3.1), a renderer may ignore it without error and apply the deduction.

---
title: Introduction au Markdown
type: document
---

Ce document peut s'ouvrir dans Writer ou être présenté slide par slide.
Ce texte-ci est visible en mode document, ignoré en présentation.

```slide
## Slide 1 — Qu'est-ce que Markdown ?
- Langage de balisage léger créé en 2004
- Devenu le standard du web et de la documentation
```

Markdown est un langage de balisage **léger** créé en 2004 — ce paragraphe reste
dans le document mais n'apparaît pas dans le diaporama.

```slide
## Slide 2 — Pourquoi l'utiliser ?
- Lisible sans outil
- Versionnable avec Git
- Universel
```

---
title: Introduction to Markdown
type: document
---

This document can be opened in Writer or presented slide by slide.
This text is visible in document mode, ignored in presentation mode.

```slide
## Slide 1 — What is Markdown?
- A lightweight markup language created in 2004
- Became the standard for the web and documentation
```

Markdown is a **lightweight** markup language created in 2004 — this paragraph
stays in the document but does not appear in the slideshow.

```slide
## Slide 2 — Why use it?
- Readable without any tool
- Versionable with Git
- Universal
```

3.3 Images et largeur Images and width

Une image s'écrit ![texte alternatif](adresse). L'adresse doit être absolue (https://) et doit désigner l'image elle-même, pas la page qui la contient. Le texte alternatif doit décrire l'image en une phrase : il est lu par les lecteurs d'écran et s'affiche si l'image ne se charge pas.

An image is written ![alt text](url). The URL must be absolute (https://) and must point at the image itself, not at the page containing it. The alt text must describe the image in one sentence: it is read by screen readers and shown if the image fails to load.

Une largeur peut être demandée par une directive w: placée dans le texte alternatif. Elle s'applique dans le corps du document comme dans une diapositive.

A width may be requested by a w: directive placed in the alt text. It applies in the document body and in a slide alike.

Un moteur de rendu doit appliquer la largeur demandée, doit retirer la directive du texte alternatif affiché et ne doit pas l'afficher comme texte. Une largeur en pourcentage ne doit jamais être rognée : l'image doit être réduite pour tenir, jamais coupée. En l'absence de directive, l'image garde sa taille d'origine.

A rendering engine must apply the requested width, must strip the directive from the displayed alt text, and must not show it as text. A percentage width must never be cropped: the image must be scaled down to fit, never cut. Without a directive, the image keeps its intrinsic size.

## Insérer un quiz

![Le menu Insérer, avec ses sept entrées w:70%](https://exemple.com/menu.png)

![Un schéma w:600](https://exemple.com/schema.png)

3.3.1 Demande explicite de disposition Explicit layout request

Un moteur de rendu peut prévoir un moyen, pour l'auteur, de demander une disposition précise plutôt que de la déduire. Cette forme n'est pas définie par la présente version de la spécification : elle est réservée. Tant qu'elle n'est pas normalisée, un rendu doit s'en tenir aux quatre dispositions déduites du § 3.2.1, et peut ignorer une telle demande sans erreur.

A rendering engine may provide a way for the author to request a specific layout instead of deducing it. This form is not defined by the present version of the specification: it is reserved. Until it is standardised, a renderer must stick to the four layouts deduced in § 3.2.1, and may ignore such a request without error.

Tableau de données en Markdown standard, accompagné d'un front matter YAML qui type les colonnes et détermine le comportement du fichier. La clé type bascule entre un rendu tableur, un quiz interactif et une FAQ.

A data table in standard Markdown, together with a YAML front matter that types the columns and determines the behaviour of the file. The type key switches between a spreadsheet rendering, an interactive quiz and a FAQ.

4.1 Tableau de données standardStandard data table

---
title: Budget prévisionnel 2025
type: table
start_date: type=date label="Date de début"
amount:     type=currency aggregations=sum label=Montant
status:     input=select values=Prévu,Validé,Annulé label=Statut
---

| start_date | amount | status |
|------------|--------|--------|
| 2025-01-01 | 12 000 | Validé |
| 2025-04-01 |  3 500 | Prévu  |

---
title: 2025 Forecast Budget
type: table
start_date: type=date label="Start date"
amount:     type=currency aggregations=sum label=Amount
status:     input=select values=Planned,Approved,Cancelled label=Status
---

| start_date | amount | status   |
|------------|--------|----------|
| 2025-01-01 | 12,000 | Approved |
| 2025-04-01 |  3,500 | Planned  |

4.2 Quiz — type: quizQuiz — type: quiz

Lorsque le front matter porte type: quiz, le fichier est rendu comme un widget interactif. Chaque ligne du tableau est une question ; la colonne type détermine la mécanique de la question (§ 8).

When the front matter carries type: quiz, the file is rendered as an interactive widget. Each table row is one question; the type column determines the question mechanic (§ 8).

---
title: Quiz — La photosynthèse
type: quiz
---

| id | type             | question                             | options                            | answer      |
|----|------------------|--------------------------------------|-----------------------------------|-------------|
| q1 | qcm_simple       | Quel gaz est produit ?               | Azote,Oxygène,CO2,Argon           | Oxygène     |
| q2 | tri_sequence     | Remettre les étapes dans l'ordre     | Absorption,Réaction,Libération O2 | Absorption,…|
| q3 | question_ouverte | Rôle de la chlorophylle ?            |                                   |             |

---
title: Quiz — Photosynthesis
type: quiz
---

| id | type             | question                          | options                       | answer      |
|----|------------------|-------------------------------------|--------------------------------|-------------|
| q1 | qcm_simple       | Which gas is produced?            | Nitrogen,Oxygen,CO2,Argon     | Oxygen      |
| q2 | tri_sequence     | Put the steps in the right order  | Absorption,Reaction,O2 Release | Absorption,…|
| q3 | question_ouverte | What is the role of chlorophyll?  |                                |             |

Mapping de colonnes — role=Column mapping — role=

Si les colonnes d'un fichier quiz n'ont pas exactement les noms attendus (import externe, ordre différent, autre langue), chaque colonne du front matter peut déclarer role=id, role=type, role=question, role=options, role=answer ou role=explanation. Sans mapping explicite, la résolution retombe sur la correspondance par nom littéral (colonnes id/type/question/options/correcte/explication) — rétrocompatible, aucun fichier existant à modifier.

If a quiz file's columns don't exactly match the expected names (external import, different order, another language), each front matter column may declare role=id, role=type, role=question, role=options, role=answer or role=explanation. Without an explicit mapping, resolution falls back to matching by literal column name (id/type/question/options/correcte/explication) — backward compatible, no existing file needs changes.

---
title: Quiz — La photosynthèse
type: quiz
qid: role=id
qtype: role=type
libelle: role=question
choix: role=options
bonne_reponse: role=answer
---

---
title: Quiz — Photosynthesis
type: quiz
qid: role=id
qtype: role=type
label: role=question
choices: role=options
right_answer: role=answer
---

4.3 FAQ — type: faqFAQ — type: faq

Lorsque le front matter porte type: faq, le fichier est rendu comme un accordéon dépliable question/réponse. Chaque ligne est une entrée. Les colonnes attendues sont question et réponse (les variantes reponse, answer devraient également être acceptées).

When the front matter carries type: faq, the file is rendered as a collapsible question/answer accordion. Each row is one entry. The expected columns are question and answer (the variants réponse and reponse should also be accepted).

---
title: FAQ — Tarifs
type: faq
---

| question                          | réponse                                   |
|------------------------------------|--------------------------------------------|
| Puis-je changer de plan à tout moment ? | Oui, sans frais, effet immédiat.    |

---
title: FAQ — Pricing
type: faq
---

| question                          | answer                                    |
|------------------------------------|--------------------------------------------|
| Can I change my plan at any time? | Yes, free of charge, effective immediately. |

Chaque colonne d'un .table.md peut être annotée dans le front matter par des propriétés clé=valeur placées sur la même ligne que le nom technique de la colonne. Ce nom technique doit correspondre exactement à l'en-tête de colonne du tableau Markdown.

Each column of a .table.md file may be annotated in the front matter with key=value properties placed on the same line as the column's technical name. That technical name must match the Markdown table column header exactly.

---
title: Contacts clients
name:       label=Nom
email:      type=email label=Email
phone:      type=phone label=Téléphone
category:   input=select values=client,prospect,partenaire label=Catégorie
birthdate:  type=date label="Date de naissance"
balance:    type=currency aggregations=sum label=Solde
rating:     type=number input=rating label=Note
notes:      input=textarea label=Notes
active:     type=boolean input=checkbox label=Actif
---

---
title: Customer Contacts
name:       label=Name
email:      type=email label=Email
phone:      type=phone label=Phone
category:   input=select values=customer,prospect,partner label=Category
birthdate:  type=date label="Date of birth"
balance:    type=currency aggregations=sum label=Balance
rating:     type=number input=rating label=Rating
notes:      input=textarea label=Notes
active:     type=boolean input=checkbox label=Active
---

5.1 Types de données — type=Data types — type=

5.2 Widgets de saisie — input=Input widgets — input=

5.3 Autres propriétésOther properties

5.4 Fonctions — formula=Functions — formula=

Le langage de formules s'inspire d'Excel mais travaille par colonne, pas par cellule : il n'existe pas de notation A1/B2 ni de plage A1:B10. Une formule doit référencer une colonne par son nom technique, et une fonction d'agrégation (SUM, AVERAGE…) reçoit la colonne entière. Le séparateur d'arguments doit être le point-virgule ; (convention Excel FR), et non la virgule.

The formula language is inspired by Excel but works by column, not by cell: there is no A1/B2 notation and no A1:B10 range. A formula must reference a column by its technical name, and an aggregation function (SUM, AVERAGE…) receives the whole column. The argument separator must be the semicolon ; (French Excel convention), not the comma.

price_ttc: type=formula formula=ROUND(price_ht*(1+vat/100);2) currency=€
total_ht:  type=formula formula=SUM(price_ht) aggregations=sum
statut:   type=formula formula=IF(stock>0;"En stock";"Épuisé")
tva_lookup: type=formula formula=VLOOKUP(reference;"taux_tva";reference;taux)

price_gross: type=formula formula=ROUND(price_net*(1+vat/100);2) currency=€
total_net:   type=formula formula=SUM(price_net) aggregations=sum
status:      type=formula formula=IF(stock>0;"In stock";"Out of stock")
vat_lookup:  type=formula formula=VLOOKUP(reference;"vat_rates";reference;rate)

Opérateurs : + - * / % ** ^, comparaisons < > <= >= = == != <>, logique && ||, concaténation texte &, ternaire ? :. Le moteur ne doit pas évaluer une formule via eval : l'implémentation de référence utilise un DSL parsé (tokenizer + AST) sans accès à window, document ni au réseau.

Operators: + - * / % ** ^, comparisons < > <= >= = == != <>, logic && ||, text concatenation &, ternary ? :. An engine must not evaluate a formula through eval: the reference implementation uses a parsed DSL (tokenizer + AST) with no access to window, document or the network.

Format de présentation compatible avec Marp — un fichier .pres.md s'ouvre directement dans VS Code avec l'extension Marp, ou dans tout outil compatible. Les slides doivent être séparées par une ligne ---.

A presentation format compatible with Marp — a .pres.md file opens directly in VS Code with the Marp extension, or in any compatible tool. Slides must be separated by a --- line.

---
marp: true
title: Introduction au Qigong
theme: default
paginate: true
---

# Introduction au Qigong

Formation certifiante — Niveau 1

---

## Les origines

Le Qigong est une pratique millénaire fondée sur la circulation du **qi**.

---

## Évaluation

![[quiz-qigong-niveau1.table.md]]

---
marp: true
title: Introduction to Qigong
theme: default
paginate: true
---

# Introduction to Qigong

Certified training — Level 1

---

## Origins

Qigong is a millennia-old practice based on the circulation of **qi**.

---

## Assessment

![[qigong-level1-quiz.table.md]]

La transclusion permet d'inclure un fichier .table.md dans un document ou une présentation. La syntaxe est inspirée d'Obsidian.

Transclusion allows a .table.md file to be embedded in a document or a presentation. The syntax is inspired by Obsidian.

![[nom-du-fichier.table.md]]

![[file-name.table.md]]

La colonne explication peut être présente pour tout type de question : son contenu est affiché après la réponse.

An explication column may be present for any question type: its content is displayed after the answer is given.

Tous les formats peuvent comporter un en-tête YAML facultatif délimité par --- au début du fichier. Un fichier sans front matter doit rester valide et être rendu avec les valeurs par défaut. Les clés non reconnues doivent être ignorées silencieusement et préservées à la réécriture (§ 1).

All formats may carry an optional YAML header delimited by --- at the start of the file. A file without a front matter must remain valid and be rendered with default values. Unrecognised keys must be silently ignored and preserved on rewrite (§ 1).

---           # délimiteur d'ouverture
clé: valeur
clé2: valeur2
---           # délimiteur de fermeture

Contenu Markdown...

---           # opening delimiter
key: value
key2: value2
---           # closing delimiter

Markdown content...

11.1 Références normativesNormative references

11.2 Références informativesInformative references

Référence bibliographique recommandée :

Recommended bibliographic reference:

Ce document est publié sous licence Creative Commons Attribution 4.0 International. Vous êtes libre de le partager et de l'adapter, y compris à des fins commerciales, à condition d'en créditer l'origine.

This document is published under the Creative Commons Attribution 4.0 International license. You are free to share and adapt it, including for commercial purposes, provided you give appropriate credit.