Simple Links

At the heart of every Twine story are links. Chapbook follows the Twine conventions for typing links, which is to say, it steals shamelessly from the syntax used by wikis everywhere.

The simplest link notation surrounds a name of a passage with double square brackets: [[A tiny door]]. This displays the title of the passage directly in the text.

Sometimes it makes sense to obscure the name of the destination in the text--perhaps because your passage is named A Grisly End, or the title of the passage is capitalized but you'd like to link it in the middle of a sentence. You can do this in two different, but equivalent ways.

You [[open the door->A Grisly End]] with great confidence.You open the door with great confidence.
The [[Miss Scarlet<-young lady]] seated in the chaise seems inexplicably guilty to you.The young lady seated in the chaise seems inexplicably guilty to you.

(The links don't lead anywhere in the examples above, of course.)

The easiest way to remember this is to think of the arrow pointing to the passage you're linking to. It doesn't matter which direction the arrow points; use the syntax that feels most comfortable to you.

You cannot use Markdown or other formatting characters inside a simple link. If you'd like to italicize a certain link, for example, put the formatting around the link instead, i.e. _[[a friend of a friend]]_. See Link Inserts for how to create a link that has formatting inside it, like a man with particular skills.

To link to another web page, enter a URL instead of a passage name. You can use any link syntax you'd like, though the arrow syntax makes your text more readable in most cases:

You [[open Twine->]] on your computer.You open Twine on your computer.

Chapbook also supports the link syntax from Twine 1 that used a vertical bar (or pipe character):

Typed Displayed
You [[open the door|A Grisly End]] with great confidence. You open the door with great confidence.

This is harder to remember than the arrow syntax, so there's little reason to use it now unless you learned it from Twine 1.