Heading (Beta)

This feature is currently available only in the TestFlight beta.

Add a heading to start writing in the outline below it. Turn your outline into a finished piece of writing. You can still move whole sections as you write.

Add a Heading to Your Outline

Start with a title. Below it, add the rows you want to turn into body text.

Add # (a number sign and a space) at the start of the title. It becomes a heading, and the lines below it switch to body text. To zoom in on a heading row, hold Cmd and click its triangle toggle icon.

You can also choose Writing Heading from the row menu, or press Cmd+T on your keyboard.

Organize Text with Paragraphs and Headings

Press Enter at the end of a heading to start its body. In the body, Enter splits a line, and Backspace at the start of a line joins it to the previous body line.

You can use Markdown in the body text. Separate paragraphs with a blank line. These paragraph breaks also appear in Preview and Markdown export.

Add headings as your draft grows. Collapse the body text to see the overall flow, or move a heading together with its text. Try a different order as you write to find the structure that works best.

Markdown uses ## and ### , but Kosshi headings always use a single # . Change heading levels by indenting the headings, without adding more # characters.

Export with Your Headings

Choose Preview from the settings menu in the upper-right corner to read through your draft. Check how paragraphs and sections flow together, then return to the outline to make changes.

This example produces the following Markdown:

# Momotaro

An old woman found a large peach floating down the river.
She carried it home to share with her husband.

Inside the peach, they found a baby boy.
They named him Momotaro and raised him together.

## The journey

Momotaro set off with millet dumplings for the road.
A dog, a monkey, and a pheasant joined him along the way.

Keep Drafting Notes with %

Start a row with % to leave yourself a note. It stays visible in the outline, but is left out of Preview and document exports such as Markdown.

For example, % Add a sentence about the dumplings. is a note to yourself. Only the note row is left out of Preview and export. Its child rows are still included. To leave out a whole branch, choose Comment Out Branch from the row menu.

You can also turn this on or off with Document Comment in the row menu, or press Cmd+/ on your keyboard.

Group Text with Private Headings

Use a % row as the parent to group text under a private heading. Create sections that help you write without adding headings to the finished piece. This is useful when you want to collapse or move part of a long draft as a whole.

# Momotaro
    % The peach and the boy
        An old woman found a large peach floating down the river.
        She carried it home to share with her husband.

        Inside the peach, they found a baby boy.
        They named him Momotaro and raised him together.
    # The journey
        Momotaro set off with millet dumplings for the road.
        A dog, a monkey, and a pheasant joined him along the way.

Here, % The peach and the boy groups the scene about the peach and the boy. You can move it as one scene while writing. When you export, the body text is kept and the private heading is left out. Use private headings with # headings to organize the text within each chapter, too.

How This Differs from Prose

Body text below a heading and rows in Prose mode look the same: both have no bullets. The difference is which rows they affect. Prose hides the bullet on each row where you turn it on. A heading hides the bullets on all the body rows below it.

With headings, you do not need to turn on Prose for each row. Choose a heading and start writing below it. Your headings are also used when you export, so you can turn your outline into a finished piece of writing.