Back to Drafter

Fountain cheat sheet

Don’t want to learn marks? Try Classic Mode.

A Fountain script is plain text: what a line looks like decides what it is. Most elements need no mark at all, and a mark at the start of a line forces it to be one thing when it would otherwise read as another. The element bar at the top of the editor writes these marks for you, only where they’re needed, and so do ⌘⌥1 to ⌘⌥7 on a Mac (Ctrl+Alt+1 to Ctrl+Alt+7 elsewhere): a scene heading, action, a character, a parenthetical, a transition, centered text, and a lyric.

New to Fountain? File → New guided screenplay and New guided stage play walk you through a first script.

Scene heading INT. or EXT., or a leading .

A line that starts with INT., EXT., EST., INT./EXT. or I/E, with a blank line before and after it, starts a scene and says where and when. Any line that starts with a dot and then a letter or number is a heading too, which is how a heading that names no place is written. A stage play’s scenes are ## lines instead (see Stage plays, below). A scene number goes at the end between # marks: INT. KITCHEN - NIGHT #12#. After pages are locked, a scene added later gets an A-number, such as 5A, and a cut scene stays as .OMITTED #12#.

INT. KITCHEN - NIGHT

.FLASHBACK

Action none, or a leading !

Any paragraph that isn’t another element is action: what we see and hear. Start it with ! when it would otherwise read as something else, such as a line in capitals with another line straight under it, which would read as a name and its dialogue.

Margaret sets down the phone.

!SILENCE.
The clock ticks.

Character capitals, or a leading @

A name in capitals on its own line, after a blank line and with dialogue straight under it, says who speaks. It can end with an extension such as (V.O.) for a voice over or (O.S.) for off screen. An @ makes a name a character even when it isn’t all capitals.

MARGARET (V.O.)
You said seven.

@McBRIDE
I did.

Dialogue none

The lines straight under a character name, with no blank line between, are what they say. A blank line ends the speech.

MARGARET
You said seven.

Parenthetical ( )

A short direction in parentheses, on its own line under a character name or between lines of their dialogue.

MARGARET
(quietly)
You said seven.

Transition ends in TO:, or a leading >

A line in capitals that ends in TO:, with a blank line before and after it, is a transition. Any other transition starts with >.

CUT TO:

>FADE OUT.

Centered text > <

Text between > and < is centered on the page.

>THE END<

Lyric ~

A line that starts with ~ is a lyric, printed in italics, on its own or within dialogue.

~Happy birthday to you,
~happy birthday to you.

Dual dialogue ^

A ^ after the second of two character names prints the two speeches side by side, as when people talk at once.

MARGARET
No.

DANNY ^
Yes.

Note [[ ]]

Text between [[ and ]] is a note to yourself. It stays in your file and never prints.

She waits. [[Too long?]]

[[Check the date.]]

Keyed note [[Key: text]]

A word and a colon at the start of a note gives it a meaning. Goal, Conflict, Outcome, Shift, and Storyline describe a scene and show on its card; a category in capitals, such as TODO, sorts a note in the Notes tab; a name, such as Sam, marks a note from a reader. Ending a note with #resolved closes it, and other #tags are yours to use.

INT. KITCHEN - NIGHT

[[Goal: Margaret wants the call to end.]]
[[TODO: Cut the second line. #resolved]]
[[Sam: Does she know yet?]]

Setup and payoff [[Setup: label]]

A [[Setup: label]] where something is planted and a [[Payoff: label]] where it comes back are matched by their label. The Notes tab lists them under Setups & payoffs, and the Problems tab advises about any with no partner. They never print.

She hides the key. [[Setup: key]]

She opens the door. [[Payoff: key]]

Boneyard /* */

Text between /* and */ is cut but kept, over as many lines as you like. It never prints, and taking the marks away brings it back.

/*
A scene you might want later.
*/

Section #

A line that starts with # names a part of the script, such as an act; ## is a part inside it, and so on. Sections build the outline and never print.

# Act One
## The phone call

Synopsis =

A line that starts with = sums up the scene or section above it, for you. It never prints.

# Act One
= Margaret waits for a call.

Page break ===

A line of three or more = signs, and nothing else, starts a new page.

She hangs up.

===

Bold, italic, and underline ** * _

Wrap words in two stars for bold, one star for italics, and underscores for underlining; they can be combined. They work in action and dialogue, not in a scene heading, a character name, or a transition, where the marks print as typed.

**Never** again.
She *almost* says it. _Today._

Title page Key: value

Lines of the form Key: value at the very top of the file make the title page, which ends at the first blank line. The usual keys are Title, Credit, Author, Source, Draft date, and Contact; a value can go on over lines indented by three spaces or a tab.

Title: The Call
Author: A. Writer
Contact:
    writer@example.com

Drafter’s settings block /* drafter */

Drafter keeps what it needs to remember about a script, such as its template, in one boneyard at the very end of the file that starts /* drafter. Other Fountain programs skip a boneyard, so the file stays portable. Drafter hides it in the editor and keeps it safe, so you never see it there; you’ll only see it if you open the file in another program. Leave it as it is: Drafter writes it.

She waits.

/* drafter
{ "v": 1, "template": "us-screenplay" }
*/

Stage plays

A stage play is written in the same Fountain, with characters, dialogue, and parentheticals as above. Its structure is different: acts and scenes are sections, and what a screenplay calls action is stage direction. On a stage play the element bar shows Act, Scene, and Stage direction, and ⌘⌥1 (Ctrl+Alt+1) writes a scene.

Act #

In a stage play, a line that starts with # starts an act, and prints as its heading.

# ACT ONE

Scene ##

In a stage play, a line that starts with ## starts a scene, and prints as its heading. A play has no INT. or EXT. headings, and no transitions: one prints as a stage direction.

# ACT ONE

## Scene 1

Stage direction none, or a leading !

In a stage play, a paragraph that isn’t another element is a stage direction: what the audience sees and hears. It follows the same rules as action.

Margaret crosses to the window.

MARGARET
Still raining.

Which template /* drafter */

A script is laid out as a stage play when the settings block at the end of its file names the stage-play template. Drafter writes it when you choose Stage play; Fountain itself has no stage play.

MARGARET
Still raining.

/* drafter
{ "v": 1, "template": "stage-play-standard" }
*/