Michael Spredemann35 downloadsWrite playable gamebooks in plain Markdown: insert read-aloud text, stat blocks and roll tables, play the book beside the manuscript, and export it for gamebook.press.
Write a gamebook in Obsidian, play it as you write, and publish it on gamebook.press.
A gamebook is a story the reader plays. They read a passage, pick what to do, and the book answers. With this plugin the book does the bookkeeping: it rolls the dice, fights the fights, keeps the character sheet and remembers the key they picked up three rooms ago. Your reader just plays.
You write it as a folder of ordinary notes. Sections are headings, choices are list items with an arrow, and the plugin writes the fiddly parts for you. You do not need to know markdown, and you do not need to know how to code.

??? and keep going. The book still plays, and the pane keeps the list of what is left.map: explored in book.md, and area:, size: and terrain: on your entries, give readers a map that fills in as they go: rooms and corridors, places outdoors as hexes. It keeps its layout as you write; Lay out again moves everything..idml to finish in InDesign or Affinity Publisher, with the monsters' numbers, the tables and a character sheet printed for a reader with dice and a pencil. A third writes an .epub from the same numbers.
## The Crossroads
Rain has turned the crossroads to mud. A lantern hangs from the signpost, still lit.
- Take the lantern -> stay here
gives: the lantern
- Walk down to the mill -> The Mill
- Go inside -> Inside the Mill
needs: the lantern
blocked: It is too dark to go in without a light.
That is the whole idea. The built-in guide (the graduation-cap icon in the ribbon) walks through the rest, and the full reference is at https://gamebook.press/docs/writing. What each game system's checks, saves and fights look like is at https://gamebook.press/docs/systems.

Your book can stay a folder on your computer forever. If you want readers, gamebook.press publishes gamebooks that play in a browser, on a phone or a laptop, with nothing to install.
To submit a book: make an account, choose your handle, ask for creator access, run Export this book as a package, and upload the file under Your books → New book. Step by step: https://gamebook.press/docs/publishing.
Until the plugin is in Obsidian's community list:
gamebook-press- and ends .zip (not "Source code"). Unzip it and put the gamebook-press folder in <your vault>/.obsidian/plugins/, so that main.js ends up at .obsidian/plugins/gamebook-press/main.js. (Windows may wrap it in a second folder when it unzips; it is the inner one you want.) Then open Settings → Community plugins, press the reload button, and switch on Gamebook Press.Live-to-Role/gamebook-plugin as a beta plugin.| Command | What it does |
|---|---|
| Start a new book | Makes a folder holding a playable example book. |
| Open the writing guide | The step-by-step guide, in the sidebar. |
| Play this book | Opens or closes the play pane on the book you are in. |
| Reload the book | Recompiles the book now. The pane also does this by itself a moment after you stop typing. |
| Insert entry with choices | A new section, with a ??? where its words go, and its choices. |
| Insert item | Adds the item to items.md and gives it to the reader at the cursor. |
| Insert monster | Adds the monster to monsters.md and puts a fight against it at the cursor. |
| Insert table | Adds a table to tables.md and draws from it at the cursor. |
| Insert entry with a table | A new section that draws from a table. |
| Insert keyword | Picks or makes a keyword, and writes it being gained, text shown only with it, or a choice that needs it. |
| Insert author's note | Writes the note at the cursor. |
| Update the contents page | Rewrites the Contents note from your headings. |
| Export this book as a package | Writes <book id>.gamebook.zip beside the book. |
| Export this book for print | Writes a print folder beside the book: an .idml file for InDesign or Affinity Publisher, the map, a report of what does not translate to paper, and layout notes. Entry numbers are kept in print-numbers.json. |
| Renumber this book for print | The same, with every entry numbered afresh. |
| Export this book as an ebook | Writes <book id>.epub into the same print folder, with the same entry numbers, each "turn to" a link. A cover.jpg, .png, .webp or .svg beside book.md is its cover. |
| Report on the fights in this book | Fights each fight 200 times as each pre-gen (or as a freshly rolled character or band each time, in a book that rolls them) and shows how often they win and what they have left. In a system with Luck, burning it and keeping it are shown apart where it makes a difference. |
| Report on a path of fights in this book | Fights the fights you pick one after another, each with the wounds the last left. Only the fights are played, not the sections between them, so healing on the way is not counted. In a band book the next member steps up when one falls. |
print folder and print-numbers.json, and the Contents note.Second Person Press is a Magical Mishap LLC creation. Patrons on Patreon fund the plugin and gamebook.press.
MIT. Dungeon Crawl Classics is a trademark of Goodman Games.