EtherPK User Docs

Planned Features

Everything on this page is planned but not built yet, and none of it has a release date. Query blocks and habits have no settled design, so their details might change. The rest of these docs describe what EtherPK does today, and the EtherPK Client changelog lists what has been released.

You can ask for a feature in the EtherPK Client issues on GitHub or in the EtherPK community on Discord. See Help And Community for more information.

Writing and editing

Planned Today Page
Dragging blocks with the mouse Move the block at the cursor and its nested blocks with Alt+Up and Alt+Down (Option on a Mac), or with Move up and Move down in the phone command bar. Outliner Blocks, Keyboard Shortcuts, EtherPK On A Phone
Folds kept between visits Folds are not saved, so folded blocks open again after a reload. Outliner Blocks
Bold, italic and highlight buttons in the phone command bar The command bar has none, so select words on one line and type the marker over them. Formatting Text, EtherPK On A Phone
Find and replace in a selection Find and replace covers the whole document, and Replace all skips names in title: and aliases:. Find And Replace
d2 code blocks drawn as diagrams A d2 block shows as plain code, including on a published site. For diagrams, use a mermaid block. Code Maths And Diagrams, Extensions

Tasks and queries

Planned Today Page
Query blocks and saved views: lists of matching documents and tasks, kept current in a document Search filters documents by property (key:value) but does not keep the filter. The Tasks view lists open tasks, with filters for name, status, priority and due date. Search, The Tasks View
Habits: recurring tasks in the graph Tasks do not repeat, so write the task again. Tasks, Templates
Planned Today Page
Search by meaning, beside Names and Text Text matches words, not meaning. AI agents can search by meaning through the Headless Client. The Headless Client
Searching inside extension blocks, such as drawings Search, the find box, search by meaning and a published site's search all skip extension blocks. Drawings, Extensions, Find And Replace
Unlinked references: mentions of a page's name without a link, beside backlinks Backlinks lists only lines that link to the page by name or alias. Backlinks, Search
Hover previews of a linked page's title and excerpt Click or tap a link to open its page in the same pane. Pages And Wikilinks

Importing

Planned Today Page
Importing into an existing graph, merging documents that share a name An import always creates a new graph. Importing A Knowledge Base
Re-encrypting imported protected documents for the existing graph, after asking once for the source graph's passphrase. Without the passphrase, they arrive unreadable. An EtherPK import keeps protected documents under the same passphrase. The import report tells you if it could not, or if their images and files will not show. Protected Documents
Optional image optimisation when importing An import copies pictures at full size. Images And Files

Publishing

Planned Today Page
Alias addresses that send visitors on to the page Links to a page go to one address, whichever of its names or aliases they use. Renaming the page changes that address, and the next publish removes the old file. A slug: key keeps the address. Publishing Your Notes As A Website
Links that reach a page in another publication Such a link goes to the site's 404 page. Publishing Your Notes As A Website

Account

Planned Today Page
Changing your name, or deleting your account and cancelling any Sync+ subscription, on the Account page The Account page has neither, so email a request from the address on your account. If you are deleting your account, cancel Sync+ first. Your EtherPK Account