Tables
A table in EtherPK is ordinary markdown - pipes and dashes - that shows as a proper grid whenever your cursor is somewhere else. Click into it and the pipes come back so you can edit the text; click away and it is a grid again. Nothing is stored except the markdown, so a table exported or mirrored to disk reads fine in any other markdown tool.
Making a table
Type / and choose Table, or on a phone tap the table button on the bar at the bottom. A
small grid pops up at your cursor: move the arrow keys (or hover) to grow the highlighted
rectangle to the number of columns and rows you want, then press Enter or tap a cell. The
count is columns by body rows - every table gets a header row on top of that.
The new table's first heading is selected, so just start typing to name it.
Where the table goes depends on the line you are on:
- On an empty bullet, the table becomes that bullet's content, so it folds, indents and moves with the bullet.
- On an empty line, it takes the line's place.
- On a line with text on it, it goes on a new line underneath, inside the same bullet if you were in one. Nothing you have typed is split or moved.
Tables cannot be started inside a code block, in frontmatter, or inside or directly next to another table - leave a blank line between two tables, or they read as one.
Editing a table
With your cursor in a table, type / again and the menu offers the table actions:
| Action | What it does |
|---|---|
| Add row | A new empty row below the one you are on |
| Add column | A new empty column to the right of the one you are on |
| Remove row | Removes the row you are on (the header cannot be removed) |
| Remove column | Removes the column you are on (a table keeps at least one) |
| Remove rows above / below | Clears everything above or below your row, keeping the header |
| Remove columns left / right | Clears everything left or right of your column |
| Format | Lines the columns up again after you have edited the text by hand |
Every action tidies the column widths as it goes, so the markdown stays readable as well as the grid.
On a phone, the four you reach for most - add row, add column, remove row, remove column -
appear on the bar at the bottom as soon as your cursor is in a table, right next to the /
button, and go away again when you leave it. A button is greyed where it would do nothing:
remove row on the header, remove column on a one-column table.