Document Syntax
Every construct EtherPK reads, on one page. A document is GitHub-flavoured markdown; EtherPK adds wikilinks, task tags, a highlight mark, display-size hints and a few frontmatter keys, and derives the rest from the text. Each row links to the page with the detail.
Structure
| Construct | Written as | Notes |
|---|---|---|
| Bullet block | - text |
Two spaces per level of nesting; a child is exactly one level under its parent. Outliner Blocks |
| Continuation line | A line indented to the bullet's text | Made with Shift+Enter. A blank one, kept indented, is a paragraph break inside the block |
| Task | - [ ] text / - [x] text |
Tags immediately after the checkbox. Tasks |
| Heading | # text to ###### text |
Nests the blocks beneath it. Breaks an outline into groups |
| Paragraph | Plain text | Prose; no outliner keys apply |
| Quote | > text |
Drawn as a panel |
| Other list markers | * text, + text, 1. text |
Kept as typed; not outliner blocks in the editor, lists on a published site |
| Rule | --- in the body |
Left as its characters. At the top of the file it opens the frontmatter |
Inline
| Construct | Written as | Notes |
|---|---|---|
| Wikilink | [[Name]] |
No `[[Name |
| Scoped link | [[[[Scope]] Name]] |
Any depth. Scoped Concepts |
| Journal link | [[2026-09-21]] |
A real calendar day. Journal Entries |
| Bold | **text** or __text__ |
Formatting Text |
| Italic | *text* or _text_ |
|
| Strikethrough | ~~text~~ |
|
| Highlight | ==text== |
The Obsidian and Logseq spelling |
| Inline code | `text` |
Nothing inside is read as markup |
| Inline maths | $…$ |
On one line. A lone $ is a dollar sign; \$ escapes one. Code Maths And Diagrams |
| Web link | [text](https://…), <https://…>, or a bare address |
http, https, mailto, tel and ftp. Links To Websites And Files |
| File link | file:///path |
Copies the path when clicked; %20 for a space |
| Image |  |
![alt|300] or ![alt|640x480] caps the display size. Images And Files |
| File | [label](../assets/name.pdf) |
Any non-image asset |
| Web image |  |
Fetched from that site each time |
Task tags
Recognised only in the run of tags immediately after the checkbox. Case-sensitive.
| Tag | Meaning |
|---|---|
#P1 #P2 #P3 |
Priority |
#W |
Waiting |
#D |
Doing |
#C |
Cancelled (the task is also ticked) |
#D-YYYY-MM-DD |
Due |
#S-YYYY-MM-DD |
Scheduled |
#C-YYYY-MM-DD |
Completed |
Blocks
| Construct | Written as | Notes |
|---|---|---|
| Code block | ```, optional language, closed by a fence of the same length at the same column |
Tildes are not fences. Four backticks to nest three. Code Maths And Diagrams |
| Maths block | ```math |
LaTeX, typeset by KaTeX. latex and tex are not recognised; there is no $$ form |
| Diagram | ```mermaid |
Mermaid syntax, drawn in place |
| Protected document | ```etherpk-cipher as a page's whole body |
Ciphertext. Never edit it. Protected Documents |
| Table | GFM pipe table | A blank line between two tables. Tables |
Inside a code block nothing is markup: no bullets, links, tasks or marks.
Frontmatter
At the very start of a file, between two lines of ---.
| Key | Meaning |
|---|---|
title |
A page's name and identity. Not used on a journal entry |
aliases |
A list of other names the page answers to |
public |
true to allow publishing |
publications |
The publications the document belongs to, by id |
publication |
Marks a page as a publication's settings page |
slug |
The page's address on a published site |
date, author |
A blog post's date and author |
| Anything else | Kept as written, not read |
Titles Aliases And Frontmatter and Publishing Your Notes As A Website have the detail.
Files
The folder that holds a graph, the file naming rules and the whitespace rules that keep a file editable are in Graph Folder Layout.