Work with tables
Markdown tables in Oyma display as an editable grid. You type into cells, move with the keys you’d use in a spreadsheet, and use menus to add, move, sort or delete rows and columns. The file on disk is always a plain Markdown table.
Create a table
Any of these work:
- Type
/tableat the start of a line and press Enter for a two-column starter table. - Press ⌘O and run
>Insert tablefor a 3×3 starter table. - Right-click and choose Insert › Table.
- Paste tab- or comma-separated data (see below).
- Type the Markdown yourself:
| Name | Role | Start |
| --- | --- | --- |
| Ana | Design | 2026-01-12 |
Alignment colons in the divider row (:---, :---:, ---:) are respected.
Move around
Click a cell to start typing in it.
| Key | What it does |
|---|---|
| ↑ ↓ ← → | Move between cells |
| Tab / ⇧Tab | Next / previous cell. Tab in the last cell adds a row |
| Enter / ⇧Enter | Cell below / above. Enter in the last row adds a row |
| Esc | Leave the table and go back to the note |
| ⌘A | Select the text in the cell, not the whole note |
| ⌫ in an empty row | Delete the row |
Bold, italic and other inline formatting work inside cells. A cell containing only an image link, such as ![[chart.png]], shows the image.
Select and edit several cells
- Click and drag to select a range of cells. ⇧-click or ⇧+arrow keys extend the range.
- ⌘C and ⌘X copy or cut the range as tab-separated text, ready to paste into a spreadsheet.
- ⌘D fills down: the top cell’s text is copied into the cells below it in each selected column.
- ⌫ or Delete clears the selected cells.
- Typing a letter replaces the text of the cell where the selection started and clears the rest of the range.
Row and column menus
Hover over a table to reveal its controls:
- Column actions (the ⋯ above each column): Insert column left, Insert column right, Move column left, Move column right, Select column, Sort ascending, Sort descending and Delete column.
- Row actions (the ⋯ beside each row): Insert row above, Insert row below, Move row up, Move row down, Select row and Delete row.
- Add row and Add column (the + buttons) add a row at the bottom or a column on the right.
When several rows or columns are selected, the delete item becomes Delete 2 rows (or columns) and removes them all at once.
Right-clicking a cell gives a shorter menu with the insert and delete actions, plus Copy table as CSV and Copy table as Markdown.
Sorting
Sort ascending and Sort descending reorder the body rows by that column. The header row stays put.
- If both cells being compared are numbers, they’re compared as numbers, so 9 comes before 10.
- Otherwise the text is compared alphabetically, ignoring case.
- Empty cells always go to the bottom, whichever direction you sort.
Sorting rewrites the rows in the file. Press ⌘Z to undo it.
Paste CSV or TSV
Copy rows from a spreadsheet, or any text where values are separated by tabs or commas, and paste into a note. If the text has at least two rows and two columns with the same number of columns in each, Oyma converts it into a Markdown table. The first row becomes the header.
Pasting into a cell of an existing table pastes plain text into that cell instead.
Column widths
Drag the edge of a column header to make it wider or narrower. Widths last while the note is open but aren’t saved, because Markdown tables can’t store them. The text in your file never changes when you resize.
Related
- Markdown basics covers formatting you can use inside cells.
- Search and the command palette explains running
>Insert tableand other commands.
Questions
Are tables saved in a special format?
No. Every table is saved as a standard GitHub-style Markdown table, so it reads correctly in Obsidian, on GitHub and in any other Markdown app.
Can I paste a table from a spreadsheet?
Yes. Copy cells from Numbers, Excel or Google Sheets and paste them into a note. Tab- or comma-separated text with at least two rows and two columns becomes a table.
Do column widths I drag get saved?
No. Dragging a column edge resizes it while the note is open. Markdown tables have no way to store widths, so the file isn't changed.