gmtales-docs Help

Collaboration

GMTales is built for shared storytelling: game masters and players author articles, discuss in notes, and keep one unified record of the campaign.

Campaign Roles

Every user in a campaign has a role. The hierarchy is Creator > GameMaster > Player > Spectator; each level includes everything below it.

Role

Permissions

Creator

Everything a GameMaster can, plus: delete the campaign, change campaign settings, manage other creators and GMs

GameMaster

Create/edit/delete own articles and images, manage groups, edit or delete any note

Player

Create/edit/delete own articles and images, write notes on articles they can view

Spectator

Read-only access to content they have visibility for

Roles are assigned when a user joins: the creator or a GM sends an invitation (email or link), and the role is applied when it's accepted.

Article Ownership

Every article has a single author, set at creation and shown on the article and in overviews. Authors have full edit rights on their own articles, and the me visibility target always means the author.

Writing Workflows

Two complementary workflows — use whichever fits the moment.

Inline Editing

Edit directly in the web editor with live Markdown preview. Best for quick edits and lightweight writing.

Import/Export

  1. Export articles as .md files (metadata is preserved as directives).

  2. Edit locally in your preferred editor — with search/replace, refactoring, or git.

  3. Import the updated files; GMTales parses metadata and creates or updates articles. The dedicated sync page previews changes and offers conflict resolution before committing.

Image references survive the round trip because GMTales resolves them by file name only — keep your local folder structure however you like, but keep image file names unique and stable. See Images.

Notes

Notes are threaded discussions on an article — for clarifications, questions, theories, and plot hooks. Open an article, scroll to Notes, write and submit.

Visibility

Notes support the same visibility rules as article segments: a note can be left open to all campaign members, restricted to a Group, or marked private to the author only. Add a visibility directive at the top of the note content:

<!-- visibility: me --> I suspect Gandalf is hiding something about the One Ring.

A private note appears only in your own view — including on the campaign Notes feed.

Campaign Notes feed

The Notes tab in campaign navigation collects every note you have permission to see across all articles, sorted by most-recent activity (a reply bumps a note to the top). Each card shows a plain-text preview, the author, the parent article, and the activity timestamp.

21 June 2026