Writing Using Porcupine

Porcupine is based on Fountain, a set of simple rules for writing screenplays in plain, readable text.

To start, simply type text that looks like a screenplay, you'll probably find you use a lot of the rules already. However, to get the most out of Porcupine, take a look at the rules summarised in the table below.

A more complete explaination of each element can be found on the Fountain syntax guide, while an example screenplay can be located in Help > Example Screenplay.

Action/Scene Description

A line of text is an Action/Scene Description by default.

You can force an Action/Scene Description by starting a line with !.

Scene Headings

A line that start with INT, EXT, EST or I/E, preceeded and followed by a blank line, will be a Scene Heading.

You can force a Scene Heading by starting a line with ..

Optionally, add a scene number to the end by containing it inside two # symbols.

Character Cues

A name in ALL CAPS, preceeded by an blank line and followed by Dialogue or a Paranthetical, will be a Character Cue.

You can force a Character Cue by starting a line with @.

Optionally, you can add an extension to the end by putting it in brackets (). This doesn't need to be in all caps.

Dialogue

Any text on the line immediately following a Character Cue or a Paranthetical will be Dialogue.

If you want to add an blank line between Dialogue, just insert two spaces.

Parenthetical

A line that starts with ( and ends with ), preceeded by a Character Cue or Dialogue will be a Parenthetical.

Dual/Simultaneous Dialogue

This isn't currently avaliable in Porcupine.

Adding ^ to the end of the line of the the second Character Cue will convert it to Dual/Simultaneous Dialogue.

Transition

A line in ALL CAPS that ends with TO:, preceeded and followed by a blank line, will be a transition.

You can force a Transition by starting a line with >.

Title Page

A Title Page is optional but must start on the first line of the document.

Each line should with either Title:, Credit:, Authors:, Source:, Draft date: or Contact:, with the answer at the end of the line.

Alternatively, if the answer requires multiple lines, your answer may go on the following lines, provided each line starts with 3 or more spaces.

You can also use your own unofficial title elements, such as Copyright:, but these won't be visible when exporting to PDF.

Centered

A line that starts with > and ends with < will be Centered.

Underlined

A section of text contained within two _ symbols will be Underlined.

Bold/Italics

A section of text contained within two sets of * will be Italics.

Similarally, text within two sets of ** will be Bold.

Finally, text within two sets of *** will be both Italics and Bold.

Page Breaks

A line that contains just === will be a Page Break.

Notes

This isn't currently avaliable in Porcupine.

A section of text contained within [[ and ]] will be Notes.

If you want a note to span blank lines, just insert two spaces.

Notes won't be visible when exporting to PDF.

Boneyard

This isn't currently avaliable in Porcupine.

A section of text contained within /* and */ will be put in the Boneyard.

This can span between lines, including blank lines.

The Boneyard won't be visible when exporting to PDF.

Section

A line that starts with one or more # symbol will be a Section.

Sections won't be visible when exporting to PDF.

Synopsis

A line that starts with = will be a Synopsis.

Synopses won't be visible when exporting to PDF.

Lyrics

A line that starts with ~ will be a Lyric.

Version History

    Saved drafts

      Length

      Lines

      Words

      Characters

      Pages

      Duration

      Action

      Dialogue

      Total