Cue: a markup language For Storytellers

Download from GitHub


Cue is a plain-text format for writing stories for print, screen, and stage. Because Cue is just plain text, it can go anywhere: Google Docs, Microsoft Word, post-it notes, napkins, or even your phone.

Cue began as a tool for writing radio-dramas, but proved so flexible during development that it was adapted for other stories, as well. Cue is simple enough and powerful enough that you can use it for novels, plays, and comics, without having to bend the language in a way it doesn't support. This gives it a distinct advantage over Markdown, a language designed for writing webpages; and Fountain, which is designed only for writing screenplays. 


Cue is designed to be intuitive and invisible whenever possible. It should look roughly the same as when it's printed on a book or in a script.


Headers are marked by one of the following four keywords and an identifier:

Act I
Chapter 1
Scene The First
Page 💯💃🎉

You can force a header by inserting a period at the beginning of the line.


Optionally, you can give each header a title by adding a hyphen.

Chapter I - An Unexpected Party


Unmarked text is treated as ordinary description.

Jack went to the store to buy some milk, but he came home with a Jack Russell Terrier instead.

Or, if you prefer a screenplay-style of prose:

The door opens to reveal Jack, both arms wrapped around a nervous Jack Russell Terrier. There is no milk to be seen.

It inherits a similar inline syntax to Markdown.

Emphasis is marked by *asterisks*.
Links to images and other embeddable files are wrapped in [brackets].


The real power of Cue comes from the way it treats dialogue. Fundamentally, dialogue is just scene description targeted at a single person. This targeted direction is called a cue.

Jack: Whatever's written here is meant specifically for me.

Any part of the mise-en-scene can have a cue if it suits the writer and production team.

Audio FX: This is a cue for the audio department.
Cut to:

That last line is an example of a self-describing cue. It doesn't need any further description because the cue name is the description.

Cues that are meant to overlap with each other can be marked with a caret.

Jack: This is a line of dialogue.
^Jill: This is a line meant to be spoken at the same time.


Cues that are meant to be sung are marked with a tilde.

Jack: ~This is a song
~That extends multiple lines
~And in theory could go on forever...


The begining of a letter (or sign, et al.) is marked with a right angle bracket.

> Dear Mr. Potter,
> You are out of eggs.
> Love,
> The Dursleys


Note that whitespace in Cue is generally ignored, allowing you to align lyrics and cues however you please.

Line spacing is also simply a matter of taste.

This is line #1.
This is line #2.

This is line #3.

Thematic Break

A line of three or more hyphens becomes a break.

It was the last she ever saw of him.
Five years later, Buttercup was betrothed to a prince...


Comments can be extremely useful for sharing notes with yourself and your collaborators, without those notes appearing in the final project. You can add a comment to the end of a line using //.

// Consider revising


Every great work deserves closure. When you've reached the end of your story simply put:

The End