gogoga Table

by jackweigogoga
5
4
3
2
1
Score: 51/100

Description

Obsidian plugin: Notion-style tables for Markdown that stay plain Markdown tables.

Reviews

No reviews yet.

Stats

16
stars
2,393
downloads
3
forks
13
days
3
days
3
days
1
total PRs
0
open PRs
1
closed PRs
0
merged PRs
18
total issues
0
open issues
18
closed issues
132
commits

Latest Version

3 days ago

Changelog

中文

新增

  • 列类型(小红书 HARUKA春花 的建议,以及计算列结果想带格式):列菜单「列类型:…」换成二级菜单,可以选普通文字、状态(单选)、多选标签、日期、数字、进度条。格子里存的仍然是看得懂的文字,没装插件也能读;类型记在表格注释的 "ty" 里。
    • 日期:编辑日期格时弹出日历,点一天就写进格子;有「今天」「清空」,也可以直接打字,日历跟着跳。写法可选 2026-11-17、2026/11/17 或日记链接 [[2026-11-17]](按日记插件设的日期格式)。整格就是日期的,统一补零、换成这一列的写法。
    • 数字:可选千分位、百分比、货币符号(¥ $ € £)和小数位,提交时按格式写好,比如打 1200 变成 ¥1,200.00。打的小数比设定的多时保留,不四舍五入丢掉。百分比列里打 12 就是 12%。计算列也能设数字格式,算出来的结果带千分位和货币符号;合计行跟着这一列的格式写。
    • 进度条:60%、3/5、0.6 这样的格子画成一条进度条,后面写原文,满了变绿。
    • 多选标签:格子里用逗号隔开几个值,每个画成彩色标签,颜色和状态列一样自动分、右键可改。编辑时列出还没选的标签,按 ↓ 挑、Enter 加上;不挑直接 Enter 就完成编辑。

English

Added

  • Column types (suggested by HARUKA春花 on Xiaohongshu, plus formatted results for calculated columns): the column menu's Column type: … opens a submenu with Text, Status (single select), Multi-select tags, Date, Number and Progress bar. Cells still hold plain readable text, so the note reads fine without the plugin; the type is saved as "ty" in the table's comment.
    • Date: editing a date cell shows a calendar; click a day to fill the cell, or use Today and Clear, or just type and the calendar follows. Write dates as 2026-11-17, 2026/11/17 or a daily note link [[2026-11-17]] (using your Daily notes date format). Cells that are only a date are padded and switched to the column's style.
    • Number: thousands separator, percent, currency (¥ $ € £) and decimals; values are written in that format when you commit, so 1200 becomes ¥1,200.00. Extra decimals you type are kept rather than rounded away. In a percent column, typing 12 gives 12%. Calculated columns can use a number format too, and the total row follows the column's format.
    • Progress bar: cells like 60%, 3/5 or 0.6 are drawn as a bar followed by the original text, green when full.
    • Multi-select tags: comma-separated values become colored tags, colored automatically like status columns and recolorable from the right-click menu. While editing, tags not yet used in the cell are listed; press ↓ to pick one and Enter to add it, or just press Enter to finish editing.

完整更新日志 / Full changelog: https://github.com/JackWeiGogoga/gogoga-table/blob/main/CHANGELOG.zh-CN.md

README file from

Github

gogoga Table

English | 简体中文

Website: obsidian.gogoga.top — screenshots, features and downloads.

Tables that look and feel like Notion or Feishu docs: click a cell to edit, color cells and resize columns in a click or a drag. Files stay plain Markdown tables, so they read fine without the plugin, on mobile and on GitHub.

The interface follows Obsidian's language setting (English and Simplified Chinese). Works on desktop and mobile.

Install

Settings → Community plugins → turn off Restricted mode → Browse, search for gogoga Table, install it, then click Enable. Updates show up there too.

Manual install

For offline machines (such as a company network) or to pin a specific version:

  1. Open the Releases page and download the three files main.js, manifest.json, styles.css under Assets. Don't download the Source code archives: they are the source code, which Obsidian can't load.
  2. In your vault's folder, go to .obsidian/plugins/, create a folder named gogoga-table, and put the files in it, so you end up with paths like <vault>/.obsidian/plugins/gogoga-table/main.js.
    • .obsidian is a hidden folder: press ⌘ ⇧ . in Finder on macOS; on Windows, tick Hidden items under View in File Explorer.
  3. Restart Obsidian (or click the refresh button under Settings → Community plugins), then enable gogoga Table in the list of installed plugins.

On phones, where moving files around is awkward, use the community plugins browser.

Usage

It works as soon as it's on: Markdown tables in Live Preview and Reading view become gogoga tables, with no new syntax to learn.

  • Edit: click a cell to select it and just type to replace it; double-click or press Enter or Space to edit the existing text. While editing, Enter finishes and moves down, Shift+Enter adds a line break inside the cell, Tab / Shift+Tab move sideways, Esc saves and stops editing (⌘Z to undo). Tab in the last cell adds a row.
  • Selected cell: arrow keys move, Delete clears, ⌘Z / ⌘⇧Z undo and redo (same history as the editor). Moving up from the first row, down from the last, or pressing Esc puts the cursor back in the text around the table.
  • Select a range: drag across cells, Shift+click, or Shift+arrow keys. Color, align or clear (Delete) a whole range at once; right-click inside a range to act on all of it, and Esc goes back to a single cell.
  • Copy and paste: ⌘C / ⌘X copy the selected cells as tab-separated text (Excel, Numbers) plus a styled HTML table (backgrounds, text colors, bold, alignment, widths, merges) that keeps its look in Feishu, Word or email; pasting back into a gogoga table uses the Markdown source, so links and bold survive. ⌘V pastes tables copied from Excel, Feishu or web pages, tab-separated text, or Markdown table source, starting at the selected cell and adding rows and columns as needed; copy one cell and paste over a range to fill every cell. Copy at least two rows and two columns and paste into another note: colors, widths, merges and status columns come back as they were.
  • Paste to create a table: paste a table copied from Excel, WPS, Numbers, Feishu, Google Sheets or a web page into your note and it becomes a table, with the first row as the header and blank lines added around it. This only happens when the clipboard holds just a table (at least 2 rows and 2 columns); inside code blocks, math and frontmatter it pastes as plain text.
  • Merge cells: select a range and right-click → Merge cells; the merged cell shows all their text and nothing is lost; unmerging gives each cell its own text back. Right-click a merged cell → Unmerge cells. Inserting rows or columns inside a merged area grows it, deleting shrinks it.
  • Add rows and columns: hover the table for plus buttons on all four edges: right and bottom add a column / row at the end, left adds a column at the start, top adds a row below the header (in Markdown the header can only be the first row). The left and top ones don't show on phones.
  • Row and column handles: with the mouse in the first column, a row handle shows on that row's left edge; with the mouse in the header row, a column handle shows on that column's top edge. Drag a handle to reorder rows or columns (backgrounds, widths and merges move along); click it for the row / column menu: insert, move, color the whole row or column, delete; the column menu also has alignment (horizontal and vertical) and auto width.
  • Right-click a cell: insert rows and columns, alignment (left / center / right, plus top / middle / bottom, per column), background, Text size (Smallest, Small, Normal, Large, Largest), clear, delete. Works on a whole range at once. Right-click a header cell for Delete header row: the next row becomes the header (handy for tables pasted in with an empty first row).
  • Column width: drag the right edge of a header cell; double-click it to go back to auto.
  • Backgrounds: gray, red, orange, yellow, green, blue and purple, taken from your theme's colors and softened, so they work in light and dark mode.
  • Fill handle: drag the small square at the bottom-right of a selection to continue a series down or right: numbers count up, numbered text (Item 1), dates, weekdays and months continue, anything else is copied; hold ⌥ to always copy. Dragging past the edge adds rows or columns.
  • Table menu (top-left corner): style for this table (Default, Zebra, Minimal, Three-line), row spacing and Table text size, align the whole table horizontally or vertically; Header rows 1 / 2 / 3 (extra header rows stick to the top together and are left out of sorting, totals and fill); Fold table (header only); First column as header, and once it's on, Freeze header column (the first column stays put when scrolling sideways); distribute columns evenly, fit to page width, auto width for all columns, clear all colors; Copy whole table (pastes back into another note with its look) and Copy as Markdown table (plain GFM, without colors or other settings); indent / outdent (hang the whole table under the list item above, or move it out of the list); delete table.
  • Fold a table: a folded table shows only its header and a "▸ Show N rows" bar, and stays folded when you reopen the note; click the bar to unfold. In Reading view, unfolding only opens it there and doesn't change the file.
  • Sort: from the column menu, A→Z or Z→A; numbers by value, dates by time, Chinese by pinyin, empty cells last; a total row stays put.
  • Duplicate and insert many: Duplicate row / column in the row and column menus; select several rows (or columns) and insert to add that many at once.
  • Checkboxes: [ ] or [x] in a cell becomes a clickable checkbox; Space toggles a selected one; right-click → Turn into checkbox.
  • Text color: the row of "A" swatches under the backgrounds in the right-click menu.
  • Calculated columns: column menu → Make calculated column… and write a formula with other columns' names in braces, e.g. {Price} * {Qty} or SUM({Jan},{Feb},{Mar}) (+ − × ÷, parentheses, SUM, AVG, MIN, MAX, ROUND). Each row is calculated and the result written into the cell; empty or non-numeric inputs leave the result empty. Type { to pick a column, the first row is previewed as you type, decimals can be Auto or 0–3. Calculated cells can't be edited by hand; renaming a header updates the formulas; click ƒx in the header to edit; "Stop calculating this column" keeps the last results.
  • Total row: column menu → Total → Sum, Average, Count, Max or Min adds a "Total" row at the bottom that updates as the data changes; new rows go above it. When columns use different kinds (average, max, count…), the row is renamed "Summary" and each number gets a small label saying how it was worked out (display only; the cell still holds just the number). Hovering a total cell also tells you.
  • Column types: column menu → Column type offers Status (single select), Multi-select tags, Date, Number and Progress bar. Status and tag values become colored labels, existing values are offered while editing, new ones get a color, and you can recolor them from the right-click menu; date cells open a calendar and can be written as 2026-11-17, 2026/11/17 or a daily note link; number columns apply thousands separators, percent, currency and decimals; progress columns draw 60% or 3/5 as a bar. Cells always stay plain text (except in encrypted columns).
  • Encrypted columns: set the column type to Encrypted and its cells store text encrypted with a master password (the same format as Meld Encrypt's inline encryption, so either can decrypt it); your notes never contain the plain text. Enter the master password once per Obsidian session; cells show ••••••, the eye button shows a cell and the copy button copies it (the clipboard is cleared after 30 seconds). Encrypted columns lock again after a while, or right away from the command palette; the master password can come from Obsidian's keychain, and Change master password re-encrypts the whole vault with a new one. You can also encrypt individual cells in regular columns from the right-click menu. If you forget the master password, the content can't be recovered.
  • While editing a cell: ⌘B bold, ⌘I italic, ⌘U underline, ⌘⇧X strikethrough, ⌘⇧H highlight, ⌘K link; type [[ for note links and # for tags. Obsidian's editor shortcuts never touch the note around the table while you're in it.
  • Commands: Insert table (pick the size on a grid; in the command palette choose gogoga Table: Insert table — the plain Insert table without the plugin name is Obsidian's own and has no size picker), Convert selected text (CSV or tab-separated) to table, and row/column insert, duplicate, delete, sort, merge, align and more, all in the command palette and bindable to hotkeys.
  • Long and wide tables: the header sticks to the top as you scroll down, and a soft shadow on either side shows when a wide table can scroll sideways; when a long, wide table's own scrollbar is below the screen, a horizontal scrollbar floats at the bottom of the view so you don't have to scroll to the end first, and middle-click autoscroll works. Drag a column wider than the page and the table keeps that width and scrolls sideways, even with Scale column widths to fit on; drag it back within the page, or use Fit to page width, and it scales again.
  • Search: when Find in file, global search or Omnisearch jumps into a table, the match in the cell gets an outline and is scrolled into view; a folded table unfolds right there.
  • Mobile: tap a cell to edit, long-press for the menu, swipe to scroll as usual; after tapping a cell its row and column handles appear, and you can drag them with a finger. A tapped cell also gets a round handle on its column's right edge: drag it sideways to resize the column, double-tap for auto width. While editing a cell, a table toolbar sits above the keyboard: Done, Undo, Redo, bold, italic, strikethrough, highlight, Insert link, Checkbox, New line in cell, Previous cell, Next cell.
  • Bold, links, [[link\|alias]], tags and math render inside cells, and links open on click (Ctrl/Cmd-click for a new tab). Screenshots and copied images paste straight into a cell and are saved as attachments; images in cells are at most 320 px wide; double-click one to view it enlarged. Right-click an image in a cell for Copy image, open, rename, move, Delete image and more; right-click a link for the same link menu as in notes. Type [[ (or 【【 with a Chinese input method) for link suggestions.

Settings

  • Enhance Markdown tables (on by default): turn off to go back to Obsidian's own tables.
  • Style: Default (Notion-like: square corners, faint lines, a light header), Zebra, Minimal, Three-line.
  • Cell side padding: how far text sits from a cell's left and right borders: 4, 6, 8 or 10 (default 10); Compact tables use at most 8.
  • Row spacing: Comfortable, Compact.
  • Tables fill the page width (off by default): tables whose column widths you haven't set stretch to the page width; display only.
  • Center tables (off by default): tables narrower than the page sit in the middle of it, in Reading view and Live Preview. Wider tables (which scroll sideways) and tables that fill the page width stay as they are; display only.
  • Table style over theme (on by default): themes like OnePage, Minimal, Blue Topaz, Border and phycat restyle table borders, header backgrounds and text colors with !important; on, tables keep this plugin's look, off, the theme's table style wins.
  • Scale column widths to fit (on by default): when a table with set column widths is wider than the page (say, with a sidebar open), its columns shrink proportionally to fit and grow back when there's room; display only, your notes keep the original widths.
  • Read-only tables in Reading view (on by default): tables are view-only in Reading view, like the rest of it; turn off to edit tables there too.
  • Crosshair highlight, Show formatting while editing a cell, Format bar when selecting text in a cell: see their descriptions in the settings tab.

What's stored in your notes

The table is a standard GFM table, with alignment in the standard :---: form. Column widths, colors, merged cells and other settings, which Markdown can't express, go in one HTML comment right below the table:

| Plan | Price | Storage |
| :--- | :---: | ---: |
| Basic | $1 | 5 GB |
| Enterprise: contact us |  | Unlimited |
<!-- gogoga-table: {"w":[120,null,200],"va":[null,"middle"],"bg":{"B2":"yellow"},"merge":["A3:B3"]} -->
  • Elsewhere, merged cells show as ordinary cells and nothing is lost: merging leaves each cell's text where it was; once you edit the merged cell, all its text goes in the top-left cell and the rest are empty.
  • Cells are addressed like Excel: columns A, B, C, and row 1 is the header. Inserting, deleting or moving rows and columns updates the comment.
  • Other editors don't show the comment, and in Obsidian the plugin hides it. It sits below the table because a comment directly above stops Obsidian's own Live Preview from recognizing the table.
  • No comment is written when nothing is set. If the comment is broken or removed, the table still shows, just without the settings it held (widths, colors, merges and so on).
  • Tables padded with spaces stay aligned after edits (CJK characters count as two columns), and tables without outer pipes are written back without them.

What the keys in the comment mean:

Key Meaning
w Width of each column in pixels; null is auto
va Vertical alignment of each column: middle, bottom; null is top
bg / fg Background / text color of a cell, keyed by cell address; the value is one of gray, red, orange, yellow, green, blue, purple
merge Merged ranges, such as "A3:B3"
fx Calculated column formula for each column, e.g. "{Price}*{Qty}"; null for ordinary columns. The cells hold the results
fxd Decimals for each calculated column (0–3); null is Auto
calc Total for each column: sum, avg, count, max, min; if any column has one, the last row is the total row
opts Status and multi-select columns: "value → color" for each column
ty Column types, one per column: {"t":"date"} (f: slash / link), {"t":"num"} (g separator, u currency, p percent, d decimals), {"t":"bar"}, {"t":"multi"}, {"t":"enc"} (encrypted)
headerCol / freeze First column as header (true) / freeze header column (1)
head Number of header rows, 2 or 3; 1 when absent
style / density This table's own style and row spacing; follows the settings when absent
fs / fz Text size multiplier for the whole table / for a cell
wide 1: a table dragged wider than the page that scrolls sideways
fold 1: folded

Entries with the wrong type or an unknown color name are ignored; unknown keys are kept as they are. For each key's values, examples, and how rich text inside cells is stored, see skills/gogoga-table/SKILL.md, which you can also hand to an AI assistant to write tables for you.

Performance

Summary

  • Tables up to a few hundred rows (a few thousand cells) are smooth: on 200 rows × 10 columns (2,000 cells), everything takes under 0.3 s, and selecting a cell or pressing an arrow key takes about 20 ms.
  • Tables with tens of thousands of cells open, scroll, select and take cell edits fine, but structural changes are slow: on 1,000 rows × 20 columns (20,000 cells), opening takes about 0.4 s, selecting about 0.15 s and editing a cell about 0.1 s; inserting a row, sorting or undoing takes 0.5–10 s. Most of that is Obsidian's own native table, which is just as slow without this plugin (see "Bottlenecks" below).
  • Recommendation: keep a table to a few thousand cells. For more data, split it into several tables, or use Obsidian Bases or a CSV file.

Stress test results

Measured in Obsidian 1.15 (macOS, Apple Silicon) with real mouse and keyboard events, from the input event to the next painted frame.

Action 200 rows × 10 columns 1,000 rows × 20 columns
Open the note until the table is drawn 0.05 s 0.4 s
Switch to Reading view 0.1 s 0.7 s
Select a cell 0.02 s 0.15 s
Move with an arrow key 0.01 s 0.1 s
Select 50 rows 0.01 s 0.1 s
Crosshair following the mouse — 0.06 s
Longest frame while scrolling 0.02 s 0.09 s
Edit a cell and write it back 0.1 s 0.1 s (2–3 s for the first edit within seconds of opening the note)
Insert a row 0.15 s 3.2 s
Sort by a column 0.1–0.26 s 3.4–10.5 s
Undo 0.2 s 0.5–14 s

The same 1,000 × 20 table without this plugin, with changes of the same size made to Obsidian's native table:

Change Native table
Change a few characters in one cell 0.16–3.1 s
Insert a row 3.1–3.4 s
Reorder all body rows (like sorting) 0.07–11 s

In 0.4.0 and earlier, the same 1,000 × 20 table took 1.6 s to open, 2.4 s to switch to Reading view, 0.2 s to select a cell and up to 9.5 s to undo. This version adds these optimizations:

  • Plain-text and number cells are shown directly instead of going through Markdown rendering one by one.
  • Selecting, arrow keys and the crosshair update only the cells that changed.
  • The crosshair is drawn as bands over the table instead of a style on each cell.
  • Writing back to the note changes only the characters that changed instead of replacing the whole table, so Obsidian's native table updates just that cell instead of rebuilding: editing a cell on a 20,000-cell table goes from about 3 s (over 10 s at worst) to about 0.1 s.

The table processing itself is fast: on 2,000 rows × 20 columns, parsing, writing back, inserting, moving and sorting each take a few milliseconds, and finding every table in a note with 200 tables takes about 3 ms.

Bottlenecks and limits

  1. Obsidian's own native table (the main reason edits are slow). In Live Preview, Obsidian builds its own table object for every table, even when this plugin's table covers it and it is never shown. When the table text changes:

    • If every change falls inside a single cell, it updates only those cells. (Cell edits in this plugin write back only the changed characters, so they take this path.)
    • Inserting or deleting rows, sorting or replacing the whole table makes it rebuild the entire table right away.

    On a 20,000-cell table that takes 3–10 s, and it varies a lot depending on whether Obsidian has finished parsing the whole note. It happens without this plugin too: that is the native table's own speed. Obsidian skips the rebuild in only two cases: changes made by its own table editor (which carry an internal marker), and tables containing a search highlight. Both are Obsidian internals that plugins can't reach. Relying on them would break the plugin when Obsidian updates, possibly to the point of tables not showing at all, so this plugin doesn't.

  2. Selecting and arrow keys take about 0.1 s in big tables. Selecting a cell makes the browser lay out and repaint the whole table, which alone takes tens of milliseconds on 20,000 cells. The hidden input that receives typing has to move into the selected cell, so that the IME candidate window shows up in the right place, and that move triggers a relayout of the whole table.

  3. Every row is drawn. There's no rendering of only the visible rows, so bigger tables take longer to open and to switch views, roughly 20 ms per 1,000 cells. The same goes for Reading view.

Running the stress tests

  • The processing stress test is scripts/tests/perf.test.ts. It runs with npm test (and in CI), with generous limits that only catch changes that make things several times slower.
  • The UI stress test (t_perf.py) lives in the e2e scripts outside this repository and runs inside Obsidian. It prints the timing table above, and turns the plugin off to time Obsidian's native table on the same note for comparison.

Current scope

  • An Advanced Tables formula comment (<!-- TBLFM -->) or a block id (^id) under a table is kept as is, with our comment after it, so formulas and block references keep working.
  • Tables at the start of a line, and tables indented under a list item (right after the item or after one blank line, every row with the same indentation). Tables in code blocks, quotes and callouts (lines starting with >), and indented text outside lists, are left to Obsidian.
  • A table directly after a paragraph (no blank line in between) is left to Obsidian.
  • When exporting to PDF, or exporting a note to an image with the Export Image plugin, tables look the same as in the note (read-only).
  • Items other plugins add to the right-click menu (such as adjustable-media's "Wrap in a layout") are merged into the table's own menu, at the end, instead of a second menu popping up.

Community

Bugs and feature requests: please open an issue with a screenshot or recording and the version. Chinese-speaking users can also join the WeChat group: add JackWeiGogoga with the note “gogoga”, or scan the QR code on the community page.

License

MIT