Documentation

Everything Laypen can do, one element at a time: the window, the page, each component you can insert, Stash, exporting and settings.

Getting started

Laypen is a document app for the Mac. A document is a page of text that can also hold tables, boards, timelines and other components, so a plan and its numbers live in the same place.

Install
Open the downloaded Laypen.dmg and drag Laypen into the Applications folder. Laypen needs macOS 13 or later and runs on Apple Silicon and Intel Macs.
First launch
A one-minute tour points out where things are. You can replay it any time from Settings › App tour.
Your first document
Press ⌘N or the + next to the workspace name. Give the page a title and start writing; everything is saved as you type.
Where your work is kept
Everything stays in one file on your Mac. There is no Laypen account and nothing is uploaded. See Your data.
The beta
The beta is free for 90 days from the first time you open the app. Settings shows how many days are left. When the 90 days are up, the app doesn’t lock: your documents stay where they are and you can keep using them. Laypen then shows a note with a link to the feedback form.

The window

The window has three parts: the sidebar on the left, the page in the middle and the format panel on the right.

Workspace
The name at the top of the sidebar. Workspaces keep unrelated work apart, for example work and home. Click the name to switch, add or rename one.
Search
The magnifier, or ⌘K, searches document titles, text and Stash.
Overview, Tasks, Calendar
Three views that gather things from all your documents: recent documents, every to-do, and every date.
Stash
A place for links, images and short notes you want to keep. See Stash.
Documents
Your documents and folders. Drag to reorder or to move a document into a folder. Right-click for more actions.
Tags
Tags you have given to documents. Click one to see every document that carries it.
Tabs
Open documents stay as tabs along the top. ⌘W closes a tab; ⇧⌘] and ⇧⌘[ move between them.
Document tools
At the top right: undo and redo, favourite, the four sidebar buttons and the … menu with exporting.
The right sidebar
One sidebar with four views, chosen with the four grouped buttons at the top right: Format (options for whatever you have selected), Stash, Notes and History. The button of the view you are looking at is highlighted. Click another button to switch; click the highlighted one, or the ×, to close the sidebar. ⌥⌘I shows Format. From version 0.9.3; earlier versions had two separate panels.
Settings, help, theme
At the bottom of the sidebar: the gear opens Settings, ? opens Help, and the three buttons switch between automatic, light and dark.

Tip Hide the sidebar with ⌃⌘S, or hide everything except the page with focus mode, ⌥⌘F.

Writing and formatting

Click on the page and type. Formatting is in the format panel, and the most common styles also have shortcuts you can type.

Headings
Type # and a space for a heading, or choose Heading or Subheading in the format panel.
Lists
- and a space starts a bulleted list; choose Numbered in the panel for a numbered one.
To-dos
[] and a space starts a to-do. Ticked and unticked to-dos from every document appear in the Tasks view.
Quote, code, divider
> and a space makes a quote, --- a divider. Code in the panel sets text in a monospaced font.
Bold, italic, underline
⌘B, ⌘I and ⌘U, or the buttons under Character. Strikethrough is there too.
Colour and highlight
Select some text and choose a Text colour or a Highlight in the format panel, or with the two A buttons in the bar that appears above the selection. Six colours each; the crossed circle removes it. Colours stay readable in the dark theme and print as they are. From version 0.9.3.
Dates and document links
Date inserts a date that also shows up in the Calendar view. Doc link inserts a link to another document.
Tags
Under the title, type a tag and press ↩. Tags appear in the sidebar.
Cover
Hover over the title and choose Add cover. The cover takes the workspace colour. Change cover offers eight colours and a drawing for each kind of document.
Page width and text size
Drag the edge of the page, or use Width and Text size at the top of the format panel.

Inserting components

A component is a block inside the page: a table, a board, a timeline. Each one is described in its own section below.

The “/” menu
On an empty line, type / and pick a component, or keep typing to filter the list.
The “+” button
Appears to the left of an empty line. It opens the same menu.
The format panel
With the cursor in text, the Insert list in the panel adds a component at that point.
Writing below a component
Click just below a component to get an empty line under it.
Selecting and removing
Click a component to select it; its options appear in the format panel, including the button that removes it.

Tip Everything you do to a component can be undone with ⌘Z.

Table

A small spreadsheet inside the page, with formulas, number formats and totals.

Editing cells
Click a cell and type. ↩ confirms and moves down, ⇥ moves right. ⇧ with an arrow key extends the selection; ⌫ clears it.
Formulas
Start with =, for example =B2*C2 or =SUM(D2:D6). The formula of the selected cell is shown in the bar above the table.
Functions
SUM, AVERAGE, MIN, MAX, COUNT, COUNTA, PRODUCT, MEDIAN, ROUND, ABS, SQRT, INT, MOD, POWER, IF, AND, OR, NOT, SUMIF and COUNTIF.
Quick formulas
With a cell selected, Total, Average, Max and Min in the format panel write the formula for you. Fill down copies a formula down the column.
Total row
Total row adds a row at the bottom that sums the columns.
Column format
Plain, thousands separator, percent, or a currency ($, €, £). The .0 and .00 buttons set the number of decimals.
Rows and columns
Add or delete them with the buttons under the table or in the format panel. Formulas adjust when a row or column is deleted.
Sort and filter
Sort ascending, Sort descending and Filter work on the selected column.
Copy and paste
Cells copied from Excel or Numbers paste into the table, and cells copied from the table paste into them.
Simple table
For text rather than numbers, insert Simple table: it looks like a table in Word, with no column letters, row numbers or formula bar. Text wraps inside the cell, ⌥↩ starts a new line in a cell, and ⇥ in the last cell adds a row. Drag the edge of any cell to resize its column or row; double-click the edge to reset. Switch to calculation table in the format panel turns it into the table described above, and back. From version 0.9.3.
Pasting tables
Copy text that contains tables from Word, Pages, Google Docs or a web page and paste it into a document: each table arrives as a simple table, in the same place between the paragraphs. Merged cells are split and cell colours are not kept. From version 0.9.3.
Show as board
Turns the table into a board grouped by one of its columns. The board stays linked: changing one changes the other.

Tip A table exports to Excel with its formulas; see Exporting.

Board

Columns of cards, for work that moves through stages.

Columns
Click a column name to rename it. Add a column at the right-hand end; each column can have its own colour.
Cards
+ at the bottom of a column adds a card. Drag a card to another column or to another place in the same column.
Card details
Click a card to open it: a description, labels, a date and a checklist. A date on a card shows up in the Calendar view.
Linked boards
A board made from a table with Show as board reads its cards from the table rows. Unlink under the board turns it into an independent board.
With the keyboard
With a card focused, ⌥← and ⌥→ move it between columns and ⌥↑ and ⌥↓ reorder it. From version 0.9.3.

Gantt chart

A timeline of tasks with start and end dates.

Tasks
+ Add task adds a row. Click the name to rename it; click the circle to mark the task as done.
Moving and resizing
Drag a bar to move the task; drag its right edge to make it longer or shorter. You can also type the dates in the format panel.
Dependencies
In the format panel, Depends on ties a task to another one, so it cannot start before the other has finished.
Milestones
A task can be turned into a milestone: a single day shown as a diamond.
Today
The vertical line marks today. Weekends are shaded.
With the keyboard
With a bar focused, ← and → move the task by a day and ⇧← and ⇧→ change its end date. From version 0.9.3.

Tip Every task also appears in the Calendar view.

Process

A row of steps that shows how far along something is.

Steps
Click a step name to rename it. Add or remove steps in the format panel.
State
Click the circle of a step to cycle it through three states: Waiting, In progress and Completed.

Cards

Images with a title and a line of text, set side by side. Good for products, people or references.

Adding cards
Add a card with +, then drop an image on it or choose one. Type the title and the text directly on the card.
Layout
One, two or three cards per row, with the image filling the card or set inside it. Both are in the format panel.
From Stash
Drag an item from the Stash drawer onto the page and it becomes a card that stays linked to the original.

Whiteboard

Sticky notes you can place freely and connect with lines.

Notes
Double-click an empty spot to add a note. Drag a note to move it; click it to type.
Connections
Drag from the dot on a note to another note to connect them.
Colour and images
Give a note a colour, or put an image on it, from the format panel.
Export
The format panel saves the whiteboard as a PNG or JPG image.
With the keyboard
⇥ adds a note connected to the current one. ⌥⇥ goes to the next note, ⌥ with an arrow key moves the note, and pressing ⌥↩ on one note and then on another connects them. The last three from version 0.9.3.

Calendar

The Calendar view shows every date from all your documents in one month.

What appears
Gantt tasks, cards with a date, to-dos and dates you inserted in text. Click an entry to open the document it comes from.
Your own events
Click a day to add an event that belongs to no document.
macOS calendars
Turn on Settings › External calendars to also see events from the Calendar app. Laypen only reads them; it never changes your calendars.
Reminders
With Settings › Notifications on, Laypen reminds you of dated items.
Calendar in a document
Type / on an empty line and choose Calendar to place a month inside the page.
Exporting dates
The .ics button on the Calendar page saves your dated items as a file that Apple Calendar, Google Calendar and Outlook can import.

Overview and Tasks

Two views that save you from opening documents to find out what is waiting.

Overview
Recent and favourite documents, what is due, and a field to start a new document. ⌘1.
Tasks
Every to-do from every document, grouped by document. Tick one here and it is ticked in the document. ⌘2.
Today’s note
⌘D opens a note for today, creating it if needed.

Stash

A place to collect things, separate from your documents: links, images and short notes you want to return to.

Adding
Paste a link or write a note in the field at the top and press ↩. Drag in images or paste them. From anywhere in the app, ⇧⌘S opens a quick-add window.
Details and fields
Click an item to give it a title and description, replace its image and add your own fields, such as price, code or supplier.
Categories
+ Category creates one, and a category can contain other categories. Right-click a category to rename or delete it. Deleting a category keeps its items.
Read and unread
Opening a link marks it as read. The Unread filter shows what is still waiting.
Using an item in a document
Open the Stash drawer with the bag icon at the top right and drag an item onto the page, or type / and choose From Stash. The card stays linked: change the original and the card changes too.
Good to know
Link titles and cover images are fetched from the internet, so offline you only see the address. Images are stored in your data file.

Templates

Nine worked examples built around real situations, and eighteen empty structures from meeting notes to a quotation.

Worked examples
Finished documents with real content: a product launch, a website build, a conference day, a content campaign, hiring, a thesis plan, a kitchen renovation, a wedding and a city trip. Each one combines a cover, cards with images, a budget that calculates itself, a Gantt chart, a board and a calendar. Open one to see how the pieces work together, then replace the details with yours. From version 0.9.3.
Using a template
Open Templates in the sidebar (⌘5) and click one. It opens as a new document you can change freely.
Your own templates
In a document, open the … menu and choose Save as template.

Organising and finding

A few tools keep a growing pile of documents manageable.

Folders
Create a folder from the File menu or by right-clicking in the document list, then drag documents into it.
Favourites
The star at the top right pins a document to the Overview.
Duplicate and move
Use the … menu to duplicate a document or to move it to a folder or another workspace.
Search
⌘K searches titles, document text and Stash. Use the arrow keys and ↩ to open a result.
Trash
Deleted documents go to the Trash at the bottom of the sidebar, where you can restore them or delete them for good.

Undo, versions and notes

Three ways to go back or leave a comment.

Undo and redo
The two arrows at the top right, or ⌘Z and ⇧⌘Z. They cover everything in the document: text, tables, boards, timelines, cards and whiteboards.
Version history
The clock icon lists earlier versions of the document. Open one to look at it and restore it if you want it back.
Notes
Select some text and click the speech-bubble icon to attach a note to it. Notes are listed in a panel beside the page and are not part of the text.

Exporting and importing

Take a document out of Laypen in the format the other person needs.

PDF
File › Export › PDF… (⇧⌘P) or the … menu opens the Export as PDF window. Laypen sets the document as one print-ready file, with a cover page, a table of contents and page numbers. The file is always light, whatever theme you use, and includes the tables, boards and timelines in the document. Sections become bookmarks, and the text stays selectable.
Colophon and approval line
In the same window, fill in Prepared by, Prepared for, Document type, Version and Status. The cover and the last page use these details. The Approval line adds space for a name, signature and date at the end, and you can turn it off. Choose A4 or US Letter under Paper.
Print
File › Print… (⌘P) opens the macOS print window.
Word
Exports the whole document as a .docx file.
Excel
Exports the tables in the document as an .xlsx file, formulas included.
Markdown and plain text
File › Export › Markdown… (⇧⌘E) saves a Markdown file, for plain-text tools. The … menu also offers plain text (.txt).
Whiteboard image
A whiteboard is saved as PNG or JPG from its format panel.
Importing
File › Import… (⇧⌘I) opens Markdown, plain-text, Word (.docx) and Excel (.xlsx) files as new documents. You can choose several at once. Word and Excel files need macOS 13.3 or later. Laypen can’t read password-protected files or the older .doc and .xls formats: save them as .docx or .xlsx first.

Settings

Open Settings with the gear at the bottom of the sidebar, or press ⌘,.

Language
English, Turkish, German, Spanish, French, Dutch, Italian, Portuguese, Japanese and Chinese.
Appearance
Light, dark, or follow macOS.
Colour palette
Two palettes: Laypen (orange on anthracite), the default, and Graphite.
Text size and page width
Small, normal or large text; a narrow, normal or wide page.
Interface scale
Makes menus, the sidebar and all text larger or smaller.
App lock
Asks for Touch ID or your Mac password when you open Laypen and after five minutes of inactivity. It locks the app window; the data file itself is not encrypted.
Spell check
Turns spell checking on or off.
External calendars
Shows events from the macOS Calendar app in the Calendar view, read-only.
Notifications
Reminders for dated items.
Updates
Laypen checks once a day whether a newer version exists. You can turn this off.
Feedback
Opens the feedback form on this site.
App tour
Replays the one-minute tour.
Data
Show in Finder opens the folder of your data file, Back up… saves a copy, and Restore from backup… loads one. See Your data.

Keyboard shortcuts

The same list is in the app under Help › Keyboard Shortcuts (⌘/).

General

⌘NNew document
⌘KSearch documents and Stash
⌘WClose tab
⇧⌘] / ⇧⌘[Next / previous tab
⌘1 – ⌘5Overview, Tasks, Calendar, Stash, Templates
⌘DToday’s note
⇧⌘SAdd to Stash
⌥⌘FFocus mode
⌥⌘IFormat panel
⌃⌘SSidebar
⌘,Settings
⌘/Help

While writing

/Insert menu
# + spaceHeading
- + spaceBulleted list
[] + spaceTo-do
> + spaceQuote
---Divider
⌘B / ⌘I / ⌘UBold, italic, underline
⌘Z / ⇧⌘ZUndo / redo

In tables

↩Edit, or confirm and move down
⇥Cell to the right
⇧ + arrowExtend the selection
⌘C / ⌘VCopy / paste (works with Excel)
⌫Clear selected cells
=Start a formula

Boards, Gantt charts and whiteboards (from 0.9.3)

⌥⇥Next sticky note
⌥ + arrowMove the sticky note
⌥↩Connect two sticky notes
⌥← / ⌥→Move the focused card to the next or previous column
⌥↑ / ⌥↓Move the focused card up or down
← / →Move the focused Gantt bar by a day
⇧← / ⇧→Shorten or extend the focused Gantt bar
↩Open the card, or select the bar

Your data

Laypen has no server. What you write stays on your Mac.

The data file
Everything is kept in one file, data.json. Images you add are stored inside the same file. Settings › Data › Show in Finder opens its folder.
Automatic backups
Laypen keeps a copy of the previous save and one copy per day for the last seven days, in the yedekler folder next to the data file.
Back up and restore
Settings › Data › Back up… saves your whole library to one file, wherever you choose. Restore from backup… replaces the current library with that file. Laypen sets the current library aside first.
If the data file is damaged
Laypen sets the damaged file aside and opens the newest sound backup.
Moving to another Mac
Make a backup and restore it on the other Mac.
What goes over the internet
Three things only. When you add a web link to Stash, Laypen reads that page once for its title and description and loads the preview image from that site. An image placed in a document by its web address loads from that address. Once a day Laypen checks for a new version; this sends no information about you or your documents and can be turned off in Settings. Send feedback opens a form in your browser; nothing goes out unless you send it.

Tip Laypen does not back up to the cloud. Keep your own backups as well, for example with Time Machine or on an external drive.

Something missing or unclear? Tell us