What is Fountain?
Fountain is a markup language for screenwriting. Instead of clicking buttons to format elements, you write naturally and Fountain converts your text into proper screenplay format. Benefits:- Write without interrupting your flow
- Plain text is future-proof and version-control friendly
- Works across any device or text editor
- Industry-standard output (identical to Final Draft)
Scene headings
Scene headings (also called slug lines) establish location and time of day.Auto-detection
Inkwell recognizes scene headings automatically when a line starts with:INT.(interior)EXT.(exterior)INT./EXT.(combined)I/E(shorthand)
Force a scene heading
If Inkwell doesn’t auto-detect your scene heading, force it by starting the line with a period (.):
Scene headings always appear in ALL CAPS. Type them in any case—Inkwell converts them automatically.
Action lines
Action lines (also called description) describe what we see on screen. They’re the default element—any regular paragraph becomes action. Example:Best practices
- Keep it visual: Describe what the camera sees, not what characters think
- Short paragraphs: Break long action into 2-3 line chunks for readability
- Present tense: “Alice walks” not “Alice walked”
- Active voice: “Bob throws the ball” not “The ball is thrown by Bob”
Character names
Character names introduce dialogue. Type them in ALL CAPS on their own line. Example:Character extensions
Add extensions in parentheses after the character name:(V.O.): Voice-over (character’s internal thoughts or narration)(O.S.): Off-screen (character is present but not visible)(CONT'D): Continued (character keeps speaking after an action line)(PRE-LAP): Dialogue begins before the scene starts(FILTERED): Voice over phone, radio, etc.
Character auto-complete
Once you’ve used a character name, Inkwell remembers it. Start typing the first few letters and pressTab to auto-complete.
Example: Type AL + Tab → ALICE
Dialogue
Dialogue is what characters say. Type it directly below a character name. Example:Multi-line dialogue
Keep typing—Inkwell handles line breaks automatically:Parentheticals
Parentheticals (also called wrylies) are brief actor directions inserted in dialogue. Wrap them in parentheses on their own line. Example:When to use parentheticals
- Actor direction:
(angry),(whispers),(sarcastic) - Brief action:
(stands),(checks watch) - Tone:
(defensive),(joking)
Dual dialogue
Dual dialogue shows two characters speaking simultaneously, with their dialogue appearing side-by-side on the page. This is used for overlapping speech or interruptions.How to create dual dialogue
Add a caret (^) after the second character’s name:
Example:
- Alice’s dialogue on the left
- Bob’s dialogue on the right
- Both at the same vertical position
The trailing caret syntax
The^ must be:
- After the character name (with a space):
BOB ^ - Not before:
^ BOBwon’t work - On the second speaker: The first character is normal, the second gets the
^
- Write the first character’s dialogue normally
- Add a blank line
- Type the second character’s name + space +
^ - Write the second character’s dialogue
Multiple lines of dual dialogue
Each character can have multiple lines, including parentheticals:When to use dual dialogue
Good uses:- Overlapping arguments: Two characters talking over each other
- Phone conversations: Both sides of a call shown simultaneously
- Interruptions: One character cutting off another
- Comedic timing: Simultaneous reactions or realizations
- Chaotic scenes: Multiple people speaking at once
- Alternating dialogue: If they’re taking turns, use normal dialogue
- Long speeches: Dual dialogue is hard to read if either block is more than 2-3 lines
- Clarity: If it confuses the reader, break it into sequential dialogue
Dual dialogue examples
Argument (overlapping):Transitions
Transitions indicate how one scene moves to the next. Type them in ALL CAPS, right-aligned. Example:CUT TO:, FADE IN:, FADE OUT., and DISSOLVE TO:.
Force a transition
If your transition isn’t auto-detected, force it with a greater-than symbol (>):
Modern screenplays use transitions sparingly. Only include them when the cut method is crucial to the story.
Centered text
Center any text by wrapping it with> and <:
Example:
- Chapter titles or act markers
- “THE END” cards
- Montage or dream sequence headers
Sections and synopses
Sections
Sections organize your script into acts, sequences, or chapters. Start a line with one or more# symbols:
Example:
#= Top-level (Acts)##= Second-level (Sequences)###= Third-level (Scene groups)
Synopses
Synopses are brief scene summaries. Start a line with=:
Example:
Inline notes
Notes are personal reminders or production notes. Wrap them in double brackets: Example:- Script notes during development
- Production notes for crew
- Revision reminders
- Research to-dos
Rich text styling
Inkwell supports bold, italic, and underline for emphasis.Bold
Wrap text in double asterisks or useCmd/Ctrl+B:
Example:
- Sound effects (
**BANG**,**CRASH**) - First character introductions
- Emphasizing important objects
Italic
Wrap text in single asterisks or useCmd/Ctrl+I:
Example:
- Emphasis in dialogue (use sparingly)
- Foreign words or titles
- Internal thoughts (though V.O. is preferred)
Underline
Wrap text in underscores or useCmd/Ctrl+U:
Example:
- Very rare in modern screenplays
- Sometimes used for signs or text on screen
Scene numbers
Scene numbers are used in production for tracking shots and scheduling.Auto-number scenes
Go to Screenplay → Number Scenes to automatically number all scene headings. Example before:Manual scene numbers
Add custom scene numbers by wrapping them in#:
Example:
Clear scene numbers
Remove all scene numbers with Screenplay → Clear Scene Numbers.Scene numbers are added during production. Don’t include them in spec scripts or early drafts.
Title pages
Title pages are stored separately in Script Info (Project Panel → Script Info tab). Inkwell auto-generates a properly formatted title page when you export to PDF. Required fields:- Title: Your screenplay name
- Written by: Your name
- Contact: Email or representation
Page breaks
Inkwell automatically handles page breaks following industry standards:- 1 page ≈ 1 minute of screen time
- Dialogue never splits across pages (actor-friendly formatting)
- MORE/CONT’D markers appear when dialogue continues across pages
Common formatting questions
Do I need to memorize Fountain syntax?
Do I need to memorize Fountain syntax?
Not really! Inkwell auto-detects most elements. Just write naturally and the editor formats it correctly. The forcing characters (
. for scenes, > for transitions, etc.) are for edge cases.Can I mix and match Fountain and manual formatting?
Can I mix and match Fountain and manual formatting?
Inkwell only supports Fountain syntax. Manual formatting (like tabs or multiple spaces) won’t work. Trust the auto-formatting—it follows industry standards.
What if Inkwell formats something incorrectly?
What if Inkwell formats something incorrectly?
Use forcing characters to override auto-detection. For example, if action is mistaken for a character name, you can’t force it, but you can rephrase. Most issues resolve by following Fountain conventions.
Can I see the raw Fountain code?
Can I see the raw Fountain code?
Yes! Export your script as Fountain (.fountain) from the File menu. This shows the plain-text markup behind the formatted view.
Are all Fountain features supported?
Are all Fountain features supported?
Inkwell supports all standard Fountain elements. Experimental or non-standard extensions may not work. Stick to the elements in this guide for best results.
Practice exercise
Write a short scene (5-10 lines) that includes:- A scene heading
- Action description
- Two characters
- One parenthetical
- One bold sound effect
Cmd/Ctrl+P to see the formatted PDF output.
You now understand all core Fountain elements! Keep writing and refer back as needed.