DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-live-markdown

d

dsh-live-markdown

Manifest valid

Obsidian-style Live Preview for Markdown in DeepSeek Harness: blocks render in place, only the block you edit shows source. Tables, images (double-click lightbox), callouts, embeds, math, folding — layout measured from Obsidian 1.15.1.

UI (client)hasBundlePatch

dsh-live-markdown

English | 中文

Obsidian-style Live Preview for Markdown inside DeepSeek Harness. A Markdown file opens in a single view where every block renders in place, and only the block — or the whole selection — you are editing shows its raw Markdown. No more switching between a rendered page and a source buffer.

Live Preview

What you get

  • Block-level editing. The active line (or the active selection) shows source; everything else stays rendered — the Live Preview behaviour of Obsidian.
  • Measured against real Obsidian. The numbers come from reading Obsidian 1.15.1 through the DevTools protocol, not from guessing: body line-height 1.5, heading padding-top 16px, list rows 26–27px, table cells 29.8px tall with 4px/8px padding and 1px #e4e4e4 borders, tables sized to content, image radius 4px.
  • Images. A full-line ![[image.png]] renders as a block widget so it occupies exactly its own height (no phantom line box), ![[image.png|300]] sets the width, and double-click opens an Obsidian-style lightbox: 90 % black backdrop, image fitted to the viewport, filename titlebar, close with backdrop click or Esc.
  • Folding for headings, bullet lists, ordered lists and task lists — hover the row for the chevron; folded state is remembered per file.
  • Editing keymap that behaves like Obsidian: Enter continues or exits lists/quotes, Backspace removes a list marker, Tab/Shift+Tab indent, Ctrl+B/Ctrl+I toggle bold/italic, Ctrl+K inserts a wikilink, Ctrl+Enter toggles a task, Ctrl+Shift+K deletes a line, Ctrl+Shift+V pastes plain text, Ctrl+S saves.
  • Tables edit in place: click a cell and type, Tab moves between cells, right-click for insert/delete row or column and alignment.
  • Blocks render with Obsidian's look: callouts (type colours, Lucide icons, -/+ folding), quotes, task lists, code fences with a language label and copy button, KaTeX math, frontmatter properties card (tags as pills), footnotes as superscripts, ==highlight==, <kbd>.
  • Links and embeds. [[note|alias]] renders with the alias, ![[note]] embeds the target note inline, hovering a wikilink shows a preview card, ![[image]]/![alt](https://raw.githubusercontent.com/Paradeluxe/dsh-live-markdown/HEAD/image) render inline.
  • Images you paste or drop are written next to the note and inserted as ![[name]].
  • Long documents stay fast. Decorations are built per viewport: a 6 600-line note rebuilds its decorations in ~5 ms and completes a keystroke in ~10 ms.
  • No keystrokes lost. Change propagation is throttled for performance but flushed before saving, switching files, or unmounting.

Screenshots

Tables and images follow Obsidian's box metrics; the table is sized to its content, the image fills the text column:

Table and image metrics

Double-click an image for the lightbox (same structure as Obsidian's: backdrop, fitted image, filename titlebar):

Image lightbox

Headings, paragraphs and lists use Obsidian's measured row heights:

Spacing

Install

Requirements

  • DSH 0.2.2-rc.3 or newer (declared as engines.dsh). The plugin is a DSH bundle: it needs no install script, so no build approval is requested.
  • Nothing else. CodeMirror 6, marked, KaTeX, DOMPurify, Shiki and the Literata font are vendored inside the package, so the preview works offline.

From GitHub

dsh plugin --profile desktop add github:Paradeluxe/dsh-live-markdown

Use the profile you actually run — desktop for the Desktop app. In the app you can also use Plugins → Add plugin and point it at a local checkout.

From npm

dsh plugin --profile desktop add @paradeluxe/dsh-live-markdown

If that package is not on npm yet, use the GitHub command above; both install the same code.

Turn it on

Open Plugins, find Obsidian-style Markdown preview and make sure it is enabled, then open any .md file from the workspace panel. The preview header keeps a switch back to the official renderer, so nothing is forced on you.

Obsidian parity

PARITY.md lists 52 Live Preview behaviours with their status and the check that covers each one. A few entries from the measured set:

BehaviourObsidian 1.15.1 (measured)This plugin
Active block shows source, the rest renders✓✓
Unfocused editor renders everything✓✓
Active range = whole selection✓✓
Body / heading row heights24px / 45–48px (16px heading padding)24px / 44–47px
Table cells29.8px tall, 4px 8px padding, 1px #e4e4e429.8px, 4px 8px, 1px #e4e4e4
Image clicksingle click does nothing, double-click opens lightboxsame
Lightbox.lightbox + rgba(0,0,0,.9) backdrop + filename barsame
Wikilink clickopens the target notecopies the target (see limitations)

Known limitations, recorded honestly in PARITY.md:

  • Wikilink/embed clicks copy the target instead of opening it — DSH's document preview has no host API for opening another file.
  • The properties card edits raw YAML; Obsidian's property type picker and "add property" affordances are not replicated.
  • Graph view, backlinks, command palette and Vim mode are host or editor features outside a Markdown renderer.
  • Colours approximate Obsidian's light theme; dark-theme tuning is basic.

How it works

index.js is the Host half: it registers the document-preview renderer and a small workspace API (list/tree/read/save plus asset for pasted images) on the desktop app's local server. client.js is the web half: it owns the preview panel, mounts one CodeMirror 6 EditorView for the whole note, and keeps decorations, block widgets, fold state, selection, undo history and save throttling in per-file memory. src/cm6-entry.js is the CodeMirror side of that editor and is bundled into vendor/cm6-live-preview.js by scripts/build-client.mjs.

Verification

Every number quoted above was measured against a real DSH instance with Playwright, and against Obsidian 1.15.1 for the layout values. docs/VERIFICATION.md records the environment, the 42-script GUI suite, the measurements behind each claim, and what remains unverified.

Development

npm install
npm run build:client   # src/cm6-entry.js -> vendor/cm6-live-preview.js
npm run smoke          # renders a sample document through the Host renderer

The plugin is verified against DSH 0.2.2-rc.3 with an automated Playwright suite (42 scripts / >200 assertions) that drives a real DSH instance: active-line semantics, folding, keymap, tables, callouts, embeds, image paste, lightbox, long-document scrolling and save/reopen integrity. The suite runs against a throwaway DSH profile; it is not shipped in this package.

Third-party assets

Vendored under vendor/, each under its own licence:

AssetLicence
CodeMirror 6MIT
marked, marked-footnoteMIT
KaTeXMIT
ShikiMIT
DOMPurifyApache-2.0 OR MPL-2.0
Literata (font)SIL Open Font License 1.1

License

MIT — see LICENSE.

1.0.1(v1.0.1)

  • 把开发期的测量与设计记录并入仓库:docs/SPEC.md(逐轮实现记录与实测数据)、docs/DESIGN.md(架构决策)。

  • scripts/render-smoke.mjs 不再依赖外部目录,npm install && npm run smoke 即可运行。

  • 这个仓库同时也是开发用工作副本,验证环境通过 link: 指向它,避免"开发目录 / 发布仓库"两份代码漂移。

  • 重建窗口内可能出现"占位克隆 + 真实编辑器"并存,已加去重(宿主里只保留真实编辑器),占位克隆 pointer-events:none,真实编辑器带 data-ghmd-live 标记。

1.0.2(v1.0.2)

  • 每个文件记住滚动位置:切走再回来、或宿主重挂载预览时,不再跳回文档顶部。
  • 排查打字时"闪动/跳动":在真实实例里用脚本逐字输入(英文 26 键、中文输入法组合输入、长文档内部滚动、小窗口)采样光标屏幕坐标与滚动位置,未复现光标或滚动位移;本轮先修掉"重挂载跳回顶部"这一确定会跳的原因。

1.0.3(v1.0.3)

修掉「一打字就闪、跳」的根因:DSH 文档预览在文件内容/mtime 变化时会重建整个预览组件,自动保存因此每 200ms 一次地把编辑器拆掉重建,表现为页面闪动。

  • 自动保存防抖 200ms → 700ms(只在停手后写盘;Ctrl+S 立即保存);
  • 预览重建时用上一帧 DOM 克隆占位(React ref 在 paint 前填充),新编辑器挂载后替换占位,逐帧采样 0 空白帧;
  • 配合 1.0.2 的滚动位置记忆与已有的光标/折叠记忆,重建后光标、滚动位置保持不变。

1.0.4(v1.0.4)

  • 自动保存防抖进一步提到 1500ms:连续打字(含 1 秒内的停顿)不再触发重建,撤销栈因此不会被重建打断;
  • 重挂载占位只对同一个文件复用(切换文件时不再可能闪现上一篇内容);
  • 关闭窗口/切后台时用 sendBeacon 兜底保存(防抖期间的输入不会丢);
  • 占位快照 pointer-events:none,真实编辑器 data-ghmd-live="1",宿主里始终只有一份真实编辑器。

保存行为(实测)

没有保存按钮,写盘是自动的。实测(真实 GUI,Playwright 轮询文件内容):

触发方式落盘延迟
停手后自动保存约 1.5 秒(防抖 1500ms + 一次往返,实测 1652ms)
Ctrl+S(编辑器内)立即(实测 0ms)
关闭窗口 / 页面卸载立即(pagehide + sendBeacon 兜底)
关闭预览标签页不立即,但挂起的保存计时器仍会执行(实测 1.5 秒内落盘)

右下角有一个保存状态提示(保存中… / 已保存;失败时显示原因并可点击重试),它不是保存按钮。

1.0.5(v1.0.5):可见期间不再写盘,所以不会再闪

根因:DSH 预览层在文件变化(mtime/内容)时会重建整个预览组件,读盘 → 重建 → 重挂载。只要写盘发生在你正看着的时候,就必然有一帧重绘。

1.0.5 的做法:你看着的时候不写盘,把写盘安排到"看不见"的时机——重建发生在你看不到的时候,视觉上永不闪。

什么时候保存说明
窗口失焦 / 切到别的应用立刻写盘(此时你在看别的窗口)
关闭/切换预览标签页卸载时立刻写盘
关闭窗口 / 页面隐藏pagehide + sendBeacon
编辑器内 Ctrl+S立刻写盘(你主动要求的)
连续 30 分钟盯着文档不操作兜底写一次(防止崩溃丢内容,正常使用几乎不会触发)

实测(真实 GUI,逐帧采样):可见状态下连续打字并等待,350 帧内编辑器节点身份变化 0 次、空白帧 0、滚动位移 0;窗口失焦后 1 秒内落盘。

代价:可见期间不会自动落盘(这是"永不闪"的前提)。如果你习惯随时关掉进程,按 Ctrl+S 或切一下窗口即可保存。

1.0.6(v1.0.6):重做折叠箭头

旧版用的是文字三角 ▸/▾(14×10 的字符盒 + 负边距),和文字基线对不齐,标题越大越明显(实测偏低 2.5–4.5px),字形也糙。

  • 换成 16×16 圆角描边 SVG chevron(1.7px 描边、圆头圆角),展开时旋转 90° 指向下,折叠时指向右,过渡 160ms;
  • 尺寸随层级:h1 20px → h6 15px,列表/任务 15px(--gh-md-chevron-size);
  • 用 --gh-md-chevron-shift 逐层级修正,实测全部上下文与文字中心偏差 ≤ 0.5px(h1–h6、有序、无序、任务实测 0–0.1px);
  • 只在悬停该行时出现(opacity 0 → 1),折叠状态常显;悬停有 4% 淡色圆形底,颜色随主题走 --dsw-alias-label-*;
  • callout 标题栏的折叠箭头也换成同一套 SVG。

折叠箭头

1.0.7(v1.0.7):修掉「重启后第一次打开样式不对」

原因有三层,都在首帧上:

  1. 文档 CSS 在首帧之后才注入:可写文件的文档样式(style[data-github-md])原先在 useEffect(paint 之后)注入,而 CM6 编辑器在 useLayoutEffect(paint 之前)就创建了 → 第一帧按「无样式布局」渲染。现在创建编辑器之前先注入 CSS,样式 effect 也改成 layout effect。
  2. 首帧先渲染静态排版:cm6Loaded 初始为 false,即使 CM6 bundle 已就绪,第一次也会先画一版静态 Markdown(块间距、表格、标题排版都与 Live Preview 不同)再切换。现在 bundle 在插件加载时就预热,且 cm6Loaded 用 window.__ghMdCm6LivePreview !== undefined 同步初始化。
  3. 可写性未确认时仍画静态排版:确认可写是一次异步读取,确认前现在渲染与编辑器同结构的空白占位(同样的 gh-md-document gh-md-cm6-document 容器与 padding),读取完成直接挂编辑器,不再出现静态→编辑器的跳变。bundle 4 秒仍未加载出来则回退静态渲染,避免一直空白。

另外补了 ResizeObserver:编辑器尺寸变化(面板展开、窗口缩放、首次测量为 0)时重算装饰窗口并重建,避免首次挂载只渲染前几行的降级排版。

实测(真实 GUI,逐帧采样):打开文档后第一帧就是 CM6 Live Preview(editor: true、staticBlocks: 0),probeStaticSeen: false;预热在打开文档前已完成(window.__ghMdCm6LivePreview 已定义、bundle script 已加载)。

1.0.8(v1.0.8):点链接不再显示「已保存」

点链接时插件会把目标复制到剪贴板(DSH 沙箱里不直接导航),反馈原本借用了保存状态条:setSaveState('saved') + 自定义文案。但状态条在 saved 分支只渲染固定的「已保存」,不读自定义文案,于是看起来"点个链接却保存了"。

  • 新增独立的复制提示条 .gh-md-copy-hint:显示「链接已复制 + 链接地址」,2 秒后自动消失,位置在保存状态条上方;
  • 点链接不再改动保存状态(也不会触发写盘);保存状态条只反映真正的保存(保存中… → 已保存);
  • 实测:点链接 → 只出现「链接已复制 https://…」、状态条不存在、剪贴板拿到地址、磁盘文件未被改写;真实保存仍然显示「保存中…」→「已保存」。

1.0.9(v1.0.9):点击链接改为真正的跳转

之前"点链接 = 复制链接"是早期在 DSH 沙箱里找不到导航接口时的权宜之计。现在接上了宿主的标签导航接口,链接行为向 Obsidian 看齐:

链接类型行为
文档内相对链接 [说明](https://github.com/Paradeluxe/dsh-live-markdown/blob/HEAD/notes/other.md)在右侧预览面板同面板跳转(替换当前标签)
Wiki 链接 [[笔记]]同上,自动补 .md
Ctrl/Cmd + 点击在面板里新开标签打开,不替换当前文档
外部链接 https://… / mailto:交给系统浏览器/新标签打开
无法解析或浏览器拦截退回"复制链接"并给出提示

实现要点:

  • 地址解析基于当前标签的 dsh-resource://file/session/<sessionId>/<path> 地址做标准 URL 解析,所以空格/中文、../、#锚点 都按 URL 语义处理;
  • 跳转调用预览标签自身的 tab.actions.openResource(address, { replaceTab: true })(来自宿主注入的 useTabInfo),因此是"替换当前预览",不是再叠一个标签;
  • 外部链接用 window.open 打开并清空 opener;被拦截时才显示复制提示条。

实测(真实 GUI):

  • markdown 相对链接 → 面板切到目标文档,标签数保持 1;
  • [[Wiki 目标]](无扩展名)→ 正确解析为 Wiki 目标.md 并跳转;
  • 目标文档里的 [[_gui_link_nav]] 反跳回源文档同样生效;
  • 外部链接 → 浏览器打开 https://example.com/nav-check,且没有出现复制提示。

1.0.10(v1.0.10):点链接打开新标签,不再覆盖当前文档

1.0.9 的跳转是"替换当前预览标签",用下来更像"覆盖":跳进去以后原文档就没了。现在改成:

操作行为
点击文档内链接 / Wiki 链接在右侧面板新开一个标签打开目标文档,原文档标签保留
再次点击同一个目标聚焦已经打开的那个标签,不会重复开
点击外部链接交给浏览器新页面打开(行为不变)
目标无法解析 / 弹窗被拦截退回"复制链接"并提示

实测(真实 GUI):点击相对链接后标签数 1 → 2、当前标签变为目标文档、原标签仍在;点回原标签正常;再点同一个 Wiki 链接标签数保持 2(去重聚焦)。

1.1.0(v1.1.0):表格加行 / 加列(对齐 Obsidian)

先用 Obsidian 1.15 实测了它的表格交互,再照着做:

Obsidian 的行为实测值本插件
表格下方悬停出现一条通栏 +高度 16px、整表宽、cursor: s-resize、透明度 0→1✅ 一致
表格右侧悬停出现一条竖 +宽度 16px、整表高、cursor: e-resize✅ 一致
+ 图标lucide plus,16px 描边图标✅ 同风格 16px 圆角描边 +
点击下方 +末尾追加一整行(空单元格)✅ 一致
点击右侧 +末尾追加一整列(表头/分隔行/所有行都补)✅ 一致
右键表格行/列的插入、删除、对齐菜单✅ 已有菜单,本次一并保证加行加列后画面同步刷新

另外修了一个从早期就存在的隐患:表格是"整块 widget",直接在它自己的范围里改文本会让 CM6 在更新中途替换高度表(表现为表格不刷新,严重时直接报 No tile/编辑器报错)。现在改为三步:先让表格回到源码态 → 再改文本 → 最后恢复渲染态,每步都是独立 transaction;撤销/重做也验证可用。

实测(真实 GUI,gui-table-add-check.mjs,11 项全过):+ 的位置与光标形状、加行后行数 +1、加列后列数 +1、右键删除列画面同步、撤销后编辑器仍可输入、全程 0 条 CM6 运行时报错。

1.1.1(v1.1.1):渲染器显示名改为「实时预览 Markdown」

文档预览里的渲染器下拉框原来显示「GitHub 风格 Markdown」,这是插件还是 dsh-github-md 时的旧名字,容易和仓库/插件名对不上。现在:

  • 中文界面:Live Preview Markdown(纯英文,与插件名一致);
  • 英文界面:Live Preview Markdown。

只改显示名,内部 id(@paradeluxe/dsh-live-markdown/live-markdown)、路由前缀、设置键都保持不变,已打开的标签和本地设置不受影响。

1.1.2(v1.1.2):渲染器名统一为纯英文

按需求把下拉框显示名统一为 Live Preview Markdown(中英文界面都一样,不再有「GitHub 风格 Markdown」或中英混排)。内部 id、路由前缀与设置键不变。

1.1.3(v1.1.3):图片放大后支持滚轮缩放

灯箱(双击图片打开的大图预览)现在支持:

操作行为
滚轮上/下以鼠标位置为中心缩放,范围 0.25× – 8×
放大后按住拖动平移图片(未放大时不拦截点击)
双击图片缩放/位置复位到 1×
0 键同样复位
Esc / 点背景关闭

实现要点:transform: translate(...) scale(...),滚轮按指针位置换算平移量,缩放时指针下的图像点保持不动;滚动事件 preventDefault,不会带动页面滚动;拖拽用 Pointer Events + 指针捕获,拖动超过 4px 时不会误触发"点背景关闭"。

顺手统一了图片预览入口:CM6 里点击图片现在复用客户端的灯箱(原来 bundle 里另有一个简化版 .gh-md-cm6-image-fullscreen),只有客户端灯箱不可用时才回退。

1.1.4(v1.1.4):修宽表格看不到「加列」加号

问题:加列的 + 条原本贴在表格右边缘外(left: 表格宽度)。当表格占满内容宽度时,这条 16px 的竖条整个落在内容区之外被裁掉——所以「加行」的 + 看得到,「加列」的看不到。

修复:把列 + 的定位改为 left: min(表格宽度, 内容宽度 - 18px),永远留在可见区域内;表格不宽时仍在右缘外侧(与 Obsidian 一致),占满宽度时则贴在表格右侧内部(悬停有浅色底 + 边框,避免和单元格内容混淆)。

回归测试补了宽表格场景(gui-table-add-check.mjs 现在 13 项):表格占满宽度时列 + 仍在可见区、悬停可见、点击仍然新增一列。

1.1.5(v1.1.5):选中整行/整列,Backspace 删除

按「选中整行或整列再按 Backspace」的思路做成了 Obsidian 同款手势:

操作行为
悬停表格每行左侧出现竖排 grip 手柄、每列上方出现横排 grip 手柄
点击手柄选中整行 / 整列(单元格浅蓝高亮,手柄高亮)
Backspace / Delete删除选中的整行 / 整列
Esc仅取消选择,不删除
点表格其它位置取消选择

选择用 tr/th 的实际几何位置计算手柄坐标(表格滚动、窗口尺寸变化时自动重排)。删除仍走统一的三段式编辑通道(源码态 → 改文本 → 渲染态),因此画面即时刷新且不会触发 CM6 高度表错误;只剩 1 列时会拒绝删除,避免产生非法表格。

原来的右键菜单(删除本行 / 删除本列等)保留,作为另一种入口。

1.1.6(v1.1.6):表格多选 + Ctrl+C 复制

行/列选择从"一次一行"升级为"连续多行/多列",并且可以复制:

操作行为
点手柄选中一行/一列(原有行为)
Shift + 点手柄从上一行/列扩展到当前行/列,整段高亮
Backspace / Delete删除选中的整段行/列(删除后至少保留 1 行/1 列)
Ctrl+C / Cmd+C把选中的行/列复制为 TSV(\t 分隔、\n 换行),可直接粘进 Excel / Numbers / 飞书表格
Esc取消选择

复制用 navigator.clipboard.writeText,不可用时回退到 document.execCommand("copy");行选区按整行复制,列选区按"每行取该列"复制成单列 TSV。

未实现:手柄拖拽排序(Obsidian 有,我们只做单击/Shift 单击选择)。

1.1.7(v1.1.7):拖拽排序 + Markdown 复制

补上了之前欠的两件事:

1. 手柄拖拽排序

  • 按住行左侧 / 列上方的 grip 手柄拖动,会出现一条 2px 落点线;松手后行/列移动到目标位置,文档同步改写;
  • 行的落点限制在表头之下(表头不会被拖走);列的落点可以到最左;
  • 拖动超过 4px 才算拖拽,否则仍按"单击选择"处理(不会误触发排序);
  • 排序同样走"源码态 → 改文本 → 渲染态"通道,画面即时刷新。

2. Ctrl+Shift+C 复制为 Markdown

  • 选中行/列后,Ctrl+C 复制 TSV(进 Excel),Ctrl+Shift+C 复制 Markdown(| 甲 | 1 | 第一行 |,直接粘回笔记);
  • 列选区复制成单列 Markdown 行。

1.1.8(v1.1.8):表格支持跨格拖拽选择

之前每个单元格是独立的可编辑区域,浏览器原生选区无法跨过单元格,所以"拖过一整行再删除"用不了;+/手柄那套入口也容易被忽略。现在补上了类似表格软件的区域选择:

操作行为
在单元格内按下并拖到其它单元格选中矩形区域(浅蓝高亮),松手后保持选区
在同一个单元格内拖动仍然是原生文本选择(编辑文本不受影响)
拖满一整行的所有列 → Backspace / Delete删除这几行
拖满一整列的所有行 → Backspace / Delete删除这几列
局部矩形(如 2×2)→ Backspace / Delete清空这些单元格的内容,表格结构不变
Ctrl+C / Ctrl+Shift+C复制选区:TSV / Markdown
Esc / 单击单元格取消选区(单击仍然进入单元格编辑)

说明:整行/整列的判定基于"选区是否覆盖所有列 / 所有行",所以 2 列表格里一次拖满两列再按 Backspace 会被当成"删除整行",这是有意的(对应你说的"选中整行再删除")。想清空内容而不是删行时,请用不覆盖全宽的矩形选区。

1.1.9(v1.1.9):修复"选中表格后按 Backspace 没反应"

复现思路:桌面版里,表格选择后焦点可能被 CM6 抢回 cm-content,而原来的 Backspace/Delete 监听挂在表格根节点(wrapper)上——按键落在 cm-content 时根本不会经过 wrapper,所以高亮还在、按 Backspace 却没有任何反应。真实鼠标拖拽 + 手工把焦点切到 cm-content 后按 Backspace 的用例已经复现并修好。

修复内容:

  1. 选区激活时把 Backspace / Delete / Ctrl+C / Esc 监听提升到 window 捕获阶段,焦点在哪里都能删;
  2. 只有在点击表格之外时才取消选区(原来点到别处也保留选区,容易误触),因此不会误伤聊天输入框等其它输入区域;
  3. 参差表格(各行单元格数不一致)按"该行自己的列数"判断整行选中,斜着少一格也能删行;
  4. 静态资源 URL 追加 ?v=1.1.9 构建版本号,避免桌面版/浏览器缓存住旧的 cm6-live-preview.js;
  5. 表格右侧预留 18px gutter:加列 + 条落在 gutter 里,不再压住最后一列(窄表格仍贴着表格右缘,宽表格也不会覆盖内容)。

验证:新增 gui-table-delete-focus-check.mjs(真实鼠标拖拽 → 把焦点切到 cm-content → Backspace),5 项全过;另跑了普通/对齐/空单元格/缩进/参差五种表格的删除矩阵。

1.1.10(v1.1.10):表格边缘不再吃掉点击(点了却跳到偏下)

复现到了这个具体问题:原来加行 + 是表格下方整行宽的透明条、加列 + 是整列高的竖条,而且表格下方/右侧那 16px 区域属于表格 widget 的一部分。于是在表格正下方点一下想接着写字时,会命中加行条 → 悄悄多出一行,光标被移到表格之后,看起来就是"点哪里却跳到偏下"。

修复:

  1. 加行 + 收成表格正下方居中的 64px 小条,加列 + 收成表格右缘垂直居中的 64px 小条;点条外的区域不再加行/加列,光标正常落到表格旁的空白行;
  2. 表格尺寸变化(单元格换行、滚动条出现、字体加载)后主动让 CM6 重新测量,避免高度表滞后导致点击/选区整体偏移;
  3. 新增 gui-table-click-edge-check.mjs(6 项):偏心点击不加行、光标落在表格后的空行、居中 + 仍能加行、点右缘外侧不加列。

如果你遇到的"点哪儿跳到下面"不在表格边缘(比如普通段落之间也会跳),把出问题的文件和大致位置告诉我,我按那个场景继续查。

1.1.11(v1.1.11):表格换行不再切断单词(对齐 Obsidian)

用 Obsidian 1.15 实测了它的表格换行行为(CDP 读计算样式):

属性Obsidian 实测值
word-breaknormal
overflow-wrapnormal
white-spacebreak-spaces
tablewidth: auto; max-width: none; table-layout: auto(按内容宽度,超宽时表格控件 overflow-x: auto 横向滚动)

之前我们的单元格用了 word-break: break-word,在窄列里会把 configuration、checkpointing、dim_batch=2 这类单词从中间切断。现在改为:

  1. 单元格 word-break: normal; overflow-wrap: normal——单词永远不会被切断,只在空格处换行;
  2. 表格 max-width: none——列宽按内容(最长的单词)撑开,跟 Obsidian 一致;
  3. 表格比面板宽时在表格内横向滚动(滚动条已加细样式),而不是把文字压到断词;
  4. 实测:configuration、checkpointing、wikitext_n1000_L128.jsonl 等单词完整显示,只有带连字符的 WikiText-103 在连字符处换行(标准排版行为)。

新增 gui-table-wrap-check.mjs(5 项):无单词被切断、word-break: normal、overflow-wrap: normal、表格适配或可横向滚动、无报错。

1.1.12(v1.1.12):页面左右留白加一点

  • .gh-md-document 左右内边距 24px → 32px;
  • 同时把 CM6 .cm-content 的内边距从「左 18 / 右 0」改为「左右各 18」(那 18px 是给折叠箭头留的空间),于是正文左右留白变成 50 / 50 对称(之前实际是 42 / 24,左侧明显更宽);
  • 表格、图片、引用等块级内容与正文左边缘对齐(都从 50px 开始);
  • 折叠箭头保留在 .cm-content 左侧的 18px 空间里,悬停展开/折叠不受影响(已回归 heading/list/ordered/task 四组折叠检查)。

实测:.gh-md-document 计算值 padding: 16px 32px 24px,.cm-line 距左右各 50px;gui-width-check 的页边距断言收紧为「≥28px 且左右相等」。

1.1.13(v1.1.13):表格操作不再让页面滚动/跳动

表格的加行、加列、删行、删列、拖拽排序最后都会把光标放到表格后面一行,而 CM6 默认会把光标滚进视野——所以在长文档里一操作表格,页面就可能滚走(表现成"跳到底部")。

修复:

  1. 表格操作最后一步改为 view.dispatch({ selection: {...}, scrollIntoView: false }),不主动滚动;
  2. 编辑前记录 .cm-scroller 的 scrollTop / scrollLeft,等重建与重新测量完成后(60ms)如果被移动超过 2px 就恢复;
  3. 新增 gui-scroll-preserve-check.mjs(8 项):在长文档中间滚动到表格后,行拖拽、点 + 加行、手柄选行 + Backspace 删除,三种操作前后 scrollTop 都不变(795→795、891→891、891→891),且表格结构确实发生变化。

1.1.14(v1.1.14):表格单元格恢复换行

1.1.11 为对齐 Obsidian 把单元格改成 word-break: normal; overflow-wrap: normal,普通单词确实不再被切断,但长 URL / 长哈希 / 长路径这类没有空格的 token 也无法换行,会把整张表撑得很宽、横向滚动。

现在改为:

  1. 渲染单元格时给长 token 内部插入 <wbr> 断点(在 / _ - . , ; : 之后,或每 12 个字符),普通英文单词不加断点——所以句子按空格换行、configuration 这类词不会被切开,而 URL 会在斜杠处、哈希会每 12 字符处换行;
  2. 单元格恢复 overflow-wrap: break-word 作为兜底,表格 max-width: 100% 重新适配面板宽度(不再横向溢出);
  3. 单元格 min-width: 3em,避免中文列被压成"一列一个字"(截图里 类型 / 长句子 现在都是正常一行)。

实测(1100px 面板):表格 301px 适配容器;长句子按单词换行、无单词被切断;URL 换成 8 行;哈希每 12 字符换行;中文正常换行;首列宽度 65px。新增/更新 gui-table-wrap-check.mjs(7 项)覆盖这些断言。

1.1.15(v1.1.15):表格选中/复制按 Obsidian 完整对齐

用 CDP 连上 Obsidian 逐项实测后,把表格的「选中 → 复制 → 剪切 → 删除 → 菜单」按 Obsidian 的行为重做:

行为Obsidian现在
Ctrl+C复制为 Markdown 表格(首行当表头 + 分隔行,列宽补空格对齐)✅ 完全一致,字符级相同
剪贴板格式text/plain(Markdown)+ text/html(表格)✅ 两种都写
Ctrl+Shift+C—(Obsidian 没有)保留为复制 TSV,方便粘到 Excel
Ctrl+X复制 Markdown 并删除选中的行/列;局部选区只清空单元格✅
Delete/Backspace覆盖整行 → 删行;覆盖整列 → 删列;局部 → 清空✅
Shift+点击以刚才的单元格为锚点扩展矩形选区✅
右键菜单行 ▸ / 列 ▸ 子菜单 + 按列升序 (A-Z) / 按列降序 (Z-A)✅ 结构与文案一致
行子菜单在上方新增行 / 在下方新增行 / 向上移动行 / 向下移动行 / 复制行 / 删除行✅
列子菜单在左侧新增列 / 在右侧新增列 / 向左移动列 / 向右移动列 / 左对齐 / 居中对齐 / 右对齐 / 复制列 / 删除列✅
按列排序保留表头,其它行按该列排序✅ 升序/降序都实现

实测(Obsidian 与插件逐条对照):整行复制 | 甲 | 1 | 第一行 | + | --- | --- | --- |;2×2 复制 | 甲 | 1 | / | --- | --- | / | 乙 | 2 |;整列复制 | 名称 | / | --- | / 三行数据——与本插件输出逐字符一致。

新增 gui-table-obsidian-check.mjs(18 项,已并入 GUI 套件)覆盖以上全部行为。

1.1.16(v1.1.16):表格选中/复制的边角行为再对齐 Obsidian

又用 CDP 实测了 Obsidian 的表格边角行为,逐条补齐:

行为Obsidian 实测现在
中英混排列宽按字符数补空格(中文算 1 格),不按显示宽度✅ 复制结果逐字符一致
单元格含 <br>原样复制 <br>,列宽按原始文本长度算✅
单元格含转义竖线 |不当作列分隔,复制时保留 |✅ 解析器已支持
单击单元格后 Ctrl+C复制整格文本(不是空)✅
单击单元格后 Ctrl+X复制整格并清空该格✅
拖拽越出表格继续扩展,自动钳制到最近的行/列(向下→最后一行,向上→表头行)✅
按列升序排序数字按数值比较:1 < 2 < 10✅

实例:\| 中 \| ab \| / \| --- \| ---- \| / \| 中文 \| abcd \| / \| a \| 中文字 \| 与 Obsidian 完全一致;<br> 与 \| 单元格的复制字符串也逐字符相同。

gui-table-obsidian-check.mjs 扩到 33 项(全部通过)。

1.1.17(v1.1.17):选区右键菜单、对齐复制、表格粘贴

继续按 CDP 实测补齐 Obsidian 的表格选中相关能力:

行为Obsidian 实测现在
复制带对齐的表格分隔行保留 :---: / ---:,单元格按对齐方向补空格✅ 与 Obsidian 逐字符一致(宽/窄表都验证)
有选区时右键弹出选区菜单:剪切 / 复制 / 粘贴 / 文本格式 ▸ / 左对齐 / 居中对齐 / 右对齐 / 清空选中的单元格 / 删除选中的单元格✅
文本格式 ▸加粗 / 倾斜 / 删除线 / 高亮 / 代码 / 数学 / 注释 / 清除格式✅ 全部实现
无选区时右键行 ▸ / 列 ▸ / 按列升降序(1.1.15 已有)✅ 两套菜单按有无选区切换
粘贴表格数据剪贴板带 HTML 表格时,从当前单元格开始按矩阵覆盖并补行✅

实测复制样例(与 Obsidian 相同):

| L        |    C     |        R |
| -------- | :------: | -------: |
| abcdefgh | abcdefgh | abcdefgh |
| a        |    b     |        c |

gui-table-obsidian-check.mjs 扩到 45 项(全部通过)。

1.1.18(v1.1.18):键盘扩展表格选区

按 Obsidian 实测补齐键盘选区:

按键Obsidian 实测现在
单元格内 Shift+↓ / Shift+↑跨格扩展成矩形选区✅
有选区时 Shift+方向键以锚点继续扩展矩形✅
有选区时普通方向键清空选区并移动活动单元格✅
文本末尾 Shift+→ / 文本开头 Shift+←越界扩展到相邻单元格✅
文本中间 Shift+→仍是原生文本选区,不扩展单元格✅ 不拦截

实现:cellNodeAt / clampCell / focusCellAt / caretOffsetInCell 四个小工具;窗口级 keydown 处理「有选区时的方向键」,单元格 keydown 处理「单元格内的 Shift+方向键」(用光标偏移判断是否在文本首尾,避免抢走普通文本选区)。

gui-table-obsidian-check.mjs 扩到 51 项(全部通过)。

1.1.19(v1.1.19):跨表复制对照测试 + :--- 左对齐保留

做了一轮跨应用对照测试:准备 9 张边角表格(中英混排、emoji、行内格式、参差行、空单元格、\|、<br>、超长单词、各种对齐组合、勾叉符号),分别在 Obsidian 和插件里「拖选整表 → Ctrl+C」,逐字符比对,结果 9/9 完全一致。

对照中发现并修掉一个真实差异:

  • Obsidian 会保留手写的「左对齐但带冒号」标记:| :--- | 复制出来仍然是 :----(冒号 + 补足宽度的破折号),而我们之前会归一化成 -----;
  • 现在解析对齐时区分 ---(left)与 :---(left-colon),渲染视觉一致,复制/分隔行按原样写出 :---。

gui-table-obsidian-check.mjs 扩到 55 项(新增 4 项对照断言::--- 保留、中文表头混合对齐、参差表补空、emoji 混排)。

1.1.20(v1.1.20):在已有行/列之间插入

之前只有表格下方/右侧的 +(只能在末尾追加),要在中间插入得走右键菜单,不太好发现。现在:

  • 鼠标移到两行之间的边界(±8px)→ 左侧留白出现一个 +,同时表格上出现一条蓝色插入线,点 + 就在该位置插入一行;
  • 鼠标移到两列之间的边界(±8px)→ 表格上方出现 + 和竖线,点一下就插入一列;
  • 行的中间、列的中部不会出现按钮,不影响原有「拖选单元格 / 点击行手柄选中整行」;
  • 原有的末尾 + 与右键菜单(行 ▸ / 列 ▸ 的新增项)保持不变。

新增 gui-table-insert-check.mjs(9 项):行中间不显示、行边界显示按钮+指示线、点击插入到正确位置、列边界同理、右键菜单插入仍可用、无页面报错。

1.1.21(v1.1.21):表格操作的撤销 / 重做

之前表格操作(加行、加列、插入、删除、拖动排序、排序、格式、对齐、粘贴)没有进入撤销历史,按 Ctrl+Z 不但撤不掉,还可能把整篇文档换成宿主应用的旧快照(表格看起来「复制」了一份)。现在:

  • 所有表格编辑都进历史,每一步单独一组(不会和前面的打字合并);
  • Ctrl+Z 撤销、Ctrl+Y / Ctrl+Shift+Z 重做,加行、插行、删行、加列、拖动排序、排序、格式、对齐、粘贴矩阵都覆盖;
  • 单元格里打字也可以直接 Ctrl+Z(单元格是 contenteditable,之前浏览器只会在格子里撤销 DOM 文本,和文档不同步);
  • 撤销/重做期间表格临时切到源码态执行(同一帧内完成,看不到闪烁),避免在 block widget 内部改文本导致的高度表错乱;
  • 修掉两个连带问题:CM6 的 keymap 对字母键忽略 Shift,导致「没有可重做内容时按 Ctrl+Shift+Z 反而撤销」;宿主应用的历史回退会在编辑器历史非空时被误触发,把整篇文档替换成旧快照。

新增 gui-undo-check.mjs(12 项)。

1.1.22(v1.1.22):修掉表格下方的「神秘加号」

现象:表格下面出现两个竖排的 +,看起来像文档里的字符。

原因:ensureStyle() 发现页面里已经有样式表就直接返回。插件热更新(或升级后不刷新页面)时,页面里留着旧版本的样式表,1.1.20 新加的「行/列之间插入」按钮没有对应的 CSS,于是按默认 div 布局渲染成两行纯文本 +。

修复:

  • ensureStyle() 发现样式表内容过期时直接替换 textContent,不再只认 id;
  • 插入按钮/指示线默认写内联 display: none,显示/隐藏也同步内联样式——即使样式表再次过期,也不可能以纯文本形式出现在表格下方。

1.1.23(v1.1.23):插入按钮严格对齐到边界线

之前的「行/列之间插入」按钮和蓝色指示线差了 1px(content-box + 1px 边框,加上字体渲染的 + 本身不在视觉中心),放大看会觉得没居中。

现在:

  • 按钮改成 box-sizing: border-box 的 16×16,+ 改用 SVG 绘制(不依赖字体基线),几何中心和视觉中心一致;
  • 列方向:按钮中心 = 列边界线中心(实测偏移 0.00px),按钮底边正好贴住表格顶边;
  • 行方向:按钮中心 = 行边界线中心(实测 0.00px),按钮右边正好贴住表格左边(落在左侧手柄的留白里)。

1.1.24(v1.1.24):去掉重复的插入按钮

表格最后一条行边界(底部)和列边界(右侧)原来同时有「边界插入 +」和「+ 胶囊」,两套按钮做的是同一件事(在末尾追加)。现在:

  • 边界插入按钮只在已有行/列之间出现(表头与第一行之间、列与列之间、最左侧一列之前);
  • 表格底部追加行用底部居中的 + 胶囊,右侧追加列用右侧的 + 胶囊(与 Obsidian 一致);
  • 因此底部/右侧不会再出现两个 + 挨在一起。

1.1.25(v1.1.25):修掉「有时候 hover 不出加号」

三个独立原因,都会让 + 时有时无:

  1. 单元格角落两个都不显示:同时靠近行边界和列边界时,原来的两个条件互相排斥(都要「另一个 > 8px」),结果一个都不显示。现在按「离哪条更近」二选一;鼠标在左侧/上方留白时按方向优先;某个方向没有可用边界时退回另一个。
  2. 表格重建后加号消失:插入行/列、撤销/重做会重建 widget,浏览器不会重新计算 :hover,+ 胶囊和插入按钮要等下一次鼠标移动才回来。现在记录最后一次指针位置,重建后用 requestAnimationFrame 补一次同步(+ 胶囊也认 .is-hover)。
  3. 从 + 按钮移回表格时被误隐藏:从按钮移到表格上会触发按钮的 mouseleave,预约 260ms 后的隐藏,把刚显示出来的另一个方向的按钮又藏掉。现在真正显示时会取消待执行的隐藏。

gui-table-insert-check.mjs 扩到 20 项(新增:重建后按钮与胶囊保持可见、单元格角落至少显示一个)。

Comments

Loading…