Pages
Pages are the core of your documents in Hillnote.
For instance, this is a page about "Pages!"—a bit meta, I know. 🤯

Hillnote files are stored as markdown
What this means for you?
If you are familiar with markdown standard markdown commands work. If you need help we always have the ‘/' command or the toolbar to help.
‘#’ for headings
‘-’ for bullets
‘1.’ for numbered lists
and more!
Every page is a plain .md file in your workspace's documents/ folder, and its images and attachments live in resources/. Any text editor can open them. Other Markdown apps can read them too.
Two parts of a file are special:
- Properties sit at the very top, between two
---lines. This is called front matter. - Comments are kept at the very end, in an HTML comment block. Leave that block as it is.
Files and folders explains the workspace folder in more detail, and What's in the file below shows how Hillnote's extras are written.

Click the code button in the top bar (Switch to Source Mode) to see and edit the raw markdown. Click it again (Switch to Rich Text Mode) to go back.
Source view has line numbers, and you can fold sections. Your edits show up in rich text when you switch back. The code button is greyed out while a page is read-only.

A few things show in the editor but aren't saved to the file: underline, text alignment and folded headings. They're gone when you reopen the page. Strikethrough is saved with single tildes, as ~text~. Everything else round-trips: open the file in another app and you see the same text.

Markdown shortcuts as you type
↵ (Enter on Windows) starts a new line in the same paragraph; press it twice for a new paragraph. In lists, quotes, code and tables it works as usual.
Type these at the start of a line, then a space:
| Type | You get |
|---|---|
# to ###### | Heading 1 to 6 |
-, + or * | Bullet list |
1. | Numbered list |
[ ] or [x] | Checklist item |
> | Quote |
Three backticks and a space start a code block, and --- adds a horizontal line. Wrap text in ** for bold, * for italic, ~~ for strikethrough, two equals signs for highlight, or backticks for inline code.
Hillnote also tidies a few characters as you type: -- becomes —, -> becomes →, (c) becomes © and 1/2 becomes ½. Press ⌫ (Backspace on Windows) straight after a change to undo it.

The Complete formatting guide shows every piece of syntax and what it looks like.
Shortcuts are your best friend
Hillnote has certain shortcuts outside of markdown syntax to help you supercharge your workflow
The ‘/' command
It does a few things
Helps you search for different formatting types
Type / in ordinary text or on an empty line, keep typing to filter the list, and press Enter to insert. Hover any block for +, which adds an empty line below and opens this menu, and the grip (six dots), which drags the block somewhere else.
Move through the list with ↑ and ↓, and press Esc to close it. Click the grip instead of dragging it for Copy, which copies the block's text, or Delete. Everything in the menu is described under Blocks below.

Allows you to directly send a question to AI
Type / and a question. When no command matches, Ask AI appears: press Enter and the answer streams into a panel.

Ask a page, a library or an agent
Ask Document and Ask Library answer from a page or library you pick, and /@ (Ask an Agent, Model, or Doc) chooses who answers. Ask Claude, Ask Cursor, Ask Codex, Ask Antigravity and Ask GitHub Copilot hand your request to that agent in the terminal (desktop app only). Only the ones turned on in Settings â–¸ AI appear.

AI Generation writes text into a scratch space, and Switch Model picks a local model. These need an AI model; see AI while you write. For handing work to an agent, see Agents in your workspace.
The ‘@’ command
Helps you link a document to the page like this → Complete formatting guide
Type @ or [[ to open Link to Document, pick a page and click Insert Link. To link straight to one heading or passage, press → on the page (or click its arrow), pick it and click Insert Section Link. The Users tab mentions a person in a shared workspace.

Links and topics covers links in depth: anchoring a passage, link previews, backlinks and more.
The ‘#’ command
Helps you add topics like #formating-reference, etc
Type # and a word, then a space, and it turns into a chip. Topics you already use are suggested as you type. Click a chip to find every page with that topic, or open the Topics graph in the sidebar to see them all.

See Links and topics for the rules a topic follows and how to use the topics graph.
The ‘$’ command
Type $ and the start of a name to insert a workspace variable: a value, such as a price or a launch date, that stays up to date on every page that uses it. Choose Create variable "$name"… at the end of the list to make a new one, and manage them all in Settings ▸ Variables. Type $= and a sum, such as $=price*1.2, to calculate.

Workspace variables covers whole-section variables, the built-ins and everything a calculation can do.
Formatting
Everything that could be accomplished in a Page is in Complete formatting guide
Select text for a menu with highlight, bold, italic, strikethrough, code, superscript, a link button, a text colour picker and Copy as.... The toolbar under the title adds headings, lists, tables, images and other blocks in one click. CMD/CTRL + SHIFT + F hides or shows it.

The formatting toolbar
The toolbar's buttons are Heading 1, Heading 2, Heading 3, Bullet List, Numbered List, Task List, Blockquote, Code Block, Add Image, Add File/Folder, Add YouTube Video, Add Figma Design, Embed Website, Insert Table, Horizontal Line, Scratch Space, Insert Tabs, AI Generation and Clear Formatting. Hover a button to see its name.
To hide or show the toolbar, press ⇧⌘F (Ctrl+Shift+F on Windows), choose Window ▸ Toggle Format Toolbar, or switch Format Toolbar in Settings ▸ Editor. It's hidden while a page is read-only.
Formatting selected text
Select text and a menu appears below it:
- highlight, bold, italic, underline, strikethrough, inline code and Superscript
- a link button: External for a web address, In this doc for a heading on this page
- Anchor section & copy link and Comment on selection
- a text colour picker (No color removes the colour)
- Copy as...: Plain Text, Rich Text or Markdown
⌘B (Ctrl+B on Windows) is bold, ⌘I (Ctrl+I) italic and ⌘. (Ctrl+.) superscript. The menu doesn't appear in tables. Underline isn't saved to the file, so it's gone when you reopen the page.

Anchor section & copy link is explained in Links and topics, Comment on selection in Comments and mentions, and the AI buttons at the end of the menu in AI while you write.
Web links
To link text, select it and click the link button. Web addresses become links as you type or paste them. In the desktop app, clicking a web link opens it in the sidebar browser, unless you turn off Open web links in the sidebar browser in Settings ▸ Editor. To link another page, use the ‘@’ command above.
Blocks
Everything in the ‘/' menu is a block you can add to a page, and many of them are on the toolbar too. Images and embeds are under Embed anything below.
Headings and sections
Heading 1, Heading 2 and Heading 3 are in the slash menu. For smaller headings, type #### to ###### and a space. ⌥⌘1 to ⌥⌘6 (Ctrl+Alt+1 to Ctrl+Alt+6 on Windows) turn a line into a heading of that level.
Hover a heading and click the arrow to its left to fold away its section. Folds aren't saved, so the page opens unfolded next time.
Inline Table of Contents adds a numbered, clickable list of the page's headings that updates as you write. To see the headings beside the page instead, open the Table of Contents panel from the top bar's More tools menu, or from its own button if you've pinned it. See App interface for the top bar.
Lists and checklists
Bullet List, Numbered List and Task List start lists. From the keyboard:
- ⇧⌘8 (Ctrl+Shift+8 on Windows) starts a bullet list, ⇧⌘7 (Ctrl+Shift+7) a numbered list and ⇧⌘9 (Ctrl+Shift+9) a checklist.
- ⇥ (Tab) indents an item and ⇧⇥ (Shift+Tab) moves it back out.
- ↵ (Enter) on an empty item ends the list.
- Click a checkbox to tick it. Checklist items can be nested.
In the file, an open item is saved as - [ ] and a ticked one as - [x].

Quotes, lines and alignment
- Quote makes a block quote (⇧⌘B, or Ctrl+Shift+B on Windows).
- Horizontal Line adds a divider.
- Paragraph and Clear Formatting turn a block back into plain text.
- Align Left, Align Center and Align Right align text while you work, but alignment isn't saved to the file.

Code blocks and diagrams
Code Block (⌥⌘C, or Ctrl+Alt+C on Windows) adds code with syntax highlighting. In its header, pick one of 26 languages (such as Python, SQL or Bash) or Plain Text; Search languages... filters them. There's also Copy code and a button that folds the code away.
Pick Mermaid to draw a diagram from text, then switch between Code and Preview. If a diagram has a small mistake, Hillnote often repairs it and shows auto-fixed; click apply to write the fix into the page.
Press ↵ (Enter on Windows) three times at the end of a code block to leave it.

Tables
Insert Table adds a three-by-three table with a header row. Click inside a table to show its controls:
- Column left, Column right, Row above and Row below add a column or row.
- Column and Row, with a bin icon, delete the current one.
- Delete table removes the table.
⇥ (Tab on Windows) moves to the next cell and ⇧⇥ (Shift+Tab) to the previous one. ⇥ in the last cell adds a row.
Tables are saved as standard Markdown tables, so keep cells to text, links and simple formatting.

Scratch spaces and tabs
Scratch Space (⌥⌘S, or Ctrl+Alt+S on Windows) adds a collapsible box for rough notes and drafts. Give it a title in Add title.... Its buttons insert the content into the page, copy it or delete the box. Inside it, ⌘A (Ctrl+A) selects only the box's content. AI tools that read the page are told the box holds rough notes.
Tabs (⌥⌘T, or Ctrl+Alt+T on Windows) adds a block with two tabs. Double-click a tab's name to rename it, click Add tab for another, and use the bin button to delete a tab, or the whole group with Delete tab group.

Templates, properties and buttons
- Every template in Settings â–¸ Templates is in the slash menu by name, such as Meeting Notes, Project Brief or Weekly Review. Choosing one inserts it at the cursor.
- Add property adds a typed property to the page; see Files and folders.
- Routine Button adds a button that runs a routine; see Automations.
- Plugin Button adds a button that sends its settings to a plugin, and plugins can add their own slash commands; see Tools.
- Your workspace's AI recipes are listed here too.

What isn't a block
There are no callout, toggle, column or maths blocks. Use a Quote or a highlight for a callout, a Scratch Space or a folded heading to tuck content away, and a code block for formulas.
Comments and mentions
Once you're signed in, you can comment on any passage. Select it, click Comment on selection in the menu, type your comment and click Post. The passage is tinted, and every comment on the page is in the Comments tab below it, where you can reply in threads.

In a shared workspace, type @, open the Users tab and click Mention to mention someone. They find the page under their mentions.
Comments and mentions covers whole-page comments, deleting comments and finding the pages that mention you.
Using AI
AI is made available via the ‘/' command or by selecting text in the document. It needs an AI model: a local one on your computer, or a cloud model once you sign in.
AI Actions in the selection menu lists Grammar, Rephrase, Ideas, Simplify and Story, then your own Custom Actions. You can configure these in settings. Customise Hillnote details how. Fix Text corrects spelling and grammar in place, using Apple Intelligence or your local model (desktop app only).

Selecting text and pressing CMD/CTRL + K opens Custom Prompt, which allows you to send any instruction to the model of your choice. It has its own model menu and a switch to include the whole page. With nothing selected, CMD/CTRL + K adds the answer at your cursor.

As you type, Hillnote may suggest the next few words: press Tab to accept. The suggestions come from phrases you've already used and are worked out on your computer, with no AI model involved.
AI while you write covers all of these tools in depth. To talk with AI about your pages in a conversation, see Chat with AI, and to speak instead of typing, see Dictation and voice.
How does AI interact with your document
AI output can appear in one of 2 ways.
Method 1 - Followup mode
Ask AI, Ideas and Story stream into a panel first. Type in Send a follow-up… to refine the answer until you get the result you are looking for, then click Accept & insert.

Method 2 - Replace and Diff
Rephrase, Simplify and Custom Prompt show their answer in the page as a change block, with Current and Proposed changes. Click Accept changes, discard changes, or Both to keep both. Until you choose, the page keeps both versions.
Grammar and Fix Text swap the text in place, so undo if you don't like it.

Embed anything
Simply use the ‘@’ symbol and link a collection (database), sheet or slide deck, and it shows right in the page. For a collection or a sheet, click Insert Database or Insert Sheet in Link to Document; a deck shows a preview you can step through. Any other page, a moodboard included, goes in as a link.
You can also embed a website, YouTube video, Figma design, PDF, audio file or HTML tool by using the ‘/' command. Images, PDFs and audio files can be pasted or dropped straight in.

Some examples are available in Complete formatting guide
The embeds in the ‘/' menu are:
- Upload Image, Upload PDF and Audio add a file from your computer or from
resources. Images and PDFs can also come from a web address, and audio can be transcribed. - Record records your voice and inserts the audio and a transcript when you stop; see Dictation and voice.
- YouTube Video, Figma Design and Website Embed embed from a link. Some websites don't allow embedding.
- File or Folder links to an item in
resources. - Upload HTML and Tools embed an HTML tool; see Tools.
Collections and sheets are covered in Database, and decks in Slides.
Images
Paste an image or drag one in. Hillnote copies it into resources/images/ in your workspace, in a folder named after the page, keeping the file's name. Add Image can also reuse an image already in resources or take an Image URL. Images can't be resized.

Saving, undo, counts and find
Hillnote saves about five seconds after you stop typing, and before you switch pages. ⌘S (Ctrl+S on Windows) saves straight away. Earlier versions are kept too; see Version history below.
⌘Z (Ctrl+Z on Windows) undoes and ⇧⌘Z (Ctrl+Shift+Z) redoes.
The counter in the bottom-left corner shows pages, words, characters and reading time in minutes, at 200 words a minute.
⌘F (Ctrl+F on Windows) opens the Search panel to find text in the page. Click a match to jump to it, or press ↵ (Enter) for the next match and ⇧↵ (Shift+Enter) for the previous one. Press ⌘F again to close it. See App interface for everything else search can do.

Version history
Hillnote saves a version of each page as you work, at most once every 10 minutes, so you don't have to do anything. Press CMD/CTRL + SHIFT + H, or choose â‹® (More Actions) â–¸ Version History, to compare earlier versions, bring back one change or restore a whole version.

Version history shows how to compare versions, bookmark the ones you want to keep and sort out sync conflicts.
Page View and export
Choose â‹® (More Actions) â–¸ Switch to Page View to lay your writing out on A4 sheets with 1-inch margins and page numbers, like a printed document. Switch to Normal View goes back. Page breaks are only for display: nothing is added to your file.

To save a copy, choose â‹® â–¸ Export as PDF (CMD/CTRL + E, desktop app only), or File â–¸ Save As... for PDF, HTML or Markdown.
Page View
Switch to Page View is in the â‹® (More Actions) menu at the right of the top bar. The choice applies to every page and is remembered. It's the same setting as the Page layout you chose during setup (Page View or Continuous). Page View isn't offered in source view.

In Page View:
- Each sheet's page number is centred in its bottom margin.
- The counter in the bottom-left corner shows where you are, for example Page 2 of 5.
- A block too tall for the space left carries on onto the next sheet.
- The pages reflow as you edit.
Page View works on ordinary pages; slides, collections, sheets and moodboards keep their own layouts.
Page width and focus
In normal view you can choose how wide the writing column is. Editor Width in Settings â–¸ Editor offers Default, Spacious and Wide, and the Window menu has the same choices. In Page View the sheet always stays A4 wide.
To focus on your writing:
- ⌘\ (Ctrl+\ on Windows) hides or shows the sidebar (Toggle Sidebar).
- ⇧⌘F (Ctrl+Shift+F on Windows) hides or shows the formatting toolbar.
- View â–¸ Toggle Fullscreen fills the screen.
- View â–¸ Zoom In, Zoom Out and Reset Zoom make everything bigger or smaller.

Export as PDF
Desktop app only.
- Press ⌘E (Ctrl+E on Windows), choose File ▸ Export as PDF, or click ⋮ ▸ Export as PDF.
- Choose where to save the file.
The PDF has A4 pages with the page number centred at the bottom. In light mode it has 1-inch margins; in dark mode it keeps the dark background, with slimmer margins.
There's no Print command, so export a PDF and print that. Slides export as a widescreen PDF; see Slides.

Other formats
- Export as HTML (in â‹®) downloads a
.zipwith a web page and its images. - File ▸ Save As... (⇧⌘S, or Ctrl+Shift+S on Windows) offers PDF, HTML and Markdown. Markdown downloads the page's
.mdfile as it is. - Export as Skill File (in ⋮) packages the page, the pages it refers to and its attachments as a skill for AI agents. Enter a Skill Name (lowercase letters a–z, numbers and hyphens, up to 64 characters) and a Description, then click Export Skill.
Exports use the saved file, so press ⌘S (Ctrl+S on Windows) first if you've just typed. There's no Word export, and moodboards can't be exported as PDF or HTML. To put pages on the web, see Publish.

What's in the file
Hillnote's extras are plain text in the file too:
- Section anchor:
[selected text]{#id} - Topic:
#topic - Mention:
[@Name](mailto:[email protected]) - Variable:
${name}, and a calculation:${=price*1.2} - Text colour: the text inside a colour tag that names the colour, which starts like
<color:#e03131> - Superscript: the text in square brackets, with a caret (
^) after the opening bracket - Page link: the page's title and path inside double square brackets, separated by a vertical bar. The path starts with
doc:, as indoc:documents/Launch%20plan.md, and spaces become%20. A link to a section adds#and the section's id.
See Links and topics, Comments and mentions and Workspace variables for what each one does.

Blocks in the file
Hillnote's own blocks are fenced with lines of three colons, so the file stays readable:
- Scratch space: starts with
:::scratchspaceand its title - Tabs:
:::tabs, with a:::tabline for each tab - Inline table of contents:
:::toc
Embeds are short tags in square brackets: the kind of embed (pdf, audio, youtube, figma, web, database or sheet), a colon and a name, followed by the file or address in round brackets. It's easiest to change blocks and embeds in rich text.

Reveal, move, edit the file elsewhere
In the sidebar, hover a page, click the 3 dot menu (â‹®) and choose Reveal in Finder (Reveal in File Explorer on Windows). To move a page, drag it to another folder in the sidebar.

You can edit the file in another app, or let an AI agent change it, while Hillnote is open. If you haven't edited the page, it reloads in place. If you have, Hillnote merges both sets of changes.
Title and icon
Every page has an icon and a title at the top.
- Click the title to rename the page. ↵ (Enter on Windows) keeps the new name and Esc cancels. The file is renamed too.
- Click the icon (Change icon) to pick another.
- Hover the header for Rename document, Make read-only, Protect with password and Add property. The read-only and password options are explained under Lock a page below.
Lock a page
You can lock a page with a password. This encrypts the page and no one can read it, not even us.
You need password to decrypt and the password is not stored anywhere. Hover the page's header and click Protect with password, or click the 3 dot menu in the sidebar > Lock with password.
These are encrypted files and the only way to decrypt them is with the password. It stays this way through sync. The password is not stored by anyone including us, so a forgotten password can't be recovered.
To stop accidental edits without a password, click Make read-only in the header instead. Enable editing undoes it.