Writing a Profile-Based Article
New 7.11
Choose a Document Profile in the Article editor, and the editor becomes a composite workspace: fixed sections stay locked and shared, editable sections are yours to write, and a live preview shows exactly what readers will see.
- ✅ Write only the sections that are actually yours to fill in
- ✅ See the fully composed document update live as you type
- ✅ Switch profiles safely — nothing is ever merged or deleted without your say
- ✅ Always know which text is your Article's own Main Body
Understanding the Composite Workspace
The composite workspace splits a profile-based Article into locked, Profile-managed Snippet Parts and editable Content Parts, with a live preview and a Raw tab showing the full composed Markdown.
| Workspace Element | Behavior |
|---|---|
| Snippet Part | Shown locked, marked "Profile-managed" — edit the Snippet itself to change it |
| Content Part | An editable section — the Article's own text for that section |
| Main Body | The one Content Part labeled as the Article's own main text |
| Live preview | Shows the fully composed document as readers will see it |
| Raw tab | Shows the full composed Markdown, Snippet Parts included |
| Layout | Switches between horizontal and vertical, plus a fullscreen editor |
Choosing or Changing a Document Profile
Choose a Document Profile in the Article editor to turn it into a composite workspace. Changing or removing the profile later works the same way:
- A confirmation explains the effect of the change before anything happens
- Sections whose names match a section in the new profile are kept automatically
- Sections with no match become Dangling Content Parts — nothing is ever merged or deleted without your say
The confirmation explains which sections are kept and which become Dangling Content Parts before the new profile is applied.
Note
This is different from editing the Document Profile itself. When someone edits the shared Document Profile's structure, every Article using it updates automatically. Dangling Content Parts only happen when an Article's own chosen profile is deliberately changed or removed.
Resolving Dangling Content Parts
A Dangling Content Part is text an Article wrote for a section that no longer exists in its current Document Profile. A red banner lists every dangling section, and you resolve each one before you can save:
| Action | Effect |
|---|---|
| Move | Move the text into a chosen section, before or after that section's existing text |
| Delete | Remove the text, after a confirmation |
| Undo | Take back a Move or Delete decision that hasn't been saved yet |
Save stays disabled until every dangling section is resolved. The server refuses the save too, returning 409 Conflict while any Dangling Content Part remains.
Example of the Dangling Content Part banner after switching to a new Document Profile.
Undo a Decision Before You Save
Choosing Move or Delete doesn't change the Article straight away. The decision is only recorded, and the dangling section's card shows what will happen when you save, for example Will be moved after the text of main (Main Body) on save. Until you save, each card also has an Undo button that takes the decision back, so you can pick a different target section or keep the text dangling while you think.
A pending decision: the section is marked to move after the Main Body text on save, and Undo is still available because nothing has been saved yet.
Editor Quality-of-Life
The composite editor labels the Main Body section directly, so it's always clear which text is the Article's own main text rather than a Profile-managed Snippet Part.
Before you edit or delete a Snippet, Template, or Document Profile, the editor shows its Usage — where it's currently referenced — so you can see the effect of a change before making it.
Example of the Usage indicator listing where a Document Profile is currently used.