XU Table Layout Helper

[!NOTE] 中文说明 表格布局助手：Markdown 表格可视化美化插件，支持表头样式（首行 / 首列 / 颜色）与表格列宽拖拽调整，宽度自动记忆，重开文件不丢失；表格宽度默认自适应铺满页面、跟随窗口缩放。

Markdown 表格零手写 CSS：全局布局设置可视化配置、实时生效；每张表格的列宽可直接用鼠标拖动调整并自动持久化。

English description below for review purposes. / 以下为英文说明，用于过审。

Visual table styling for Markdown tables: header styles (first row / first column / color), drag-to-resize column widths with automatic per-table memory, adaptive fill that keeps tables full-width and responsive, and instant apply in both reading view and live preview — no hand-written CSS.

功能特性

• 表头样式：首行作为表头（默认开启）/ 首列作为表头，两者可同时开启；表头默认加粗，颜色可选（留空跟随主题）
• 列宽拖拽：鼠标悬停表头单元格右边缘出现拖拽手柄，按住拖动即可调整列宽，拖拽时实时显示像素值；双击手柄可输入精确像素值
• 列宽记忆：每张表格的列宽自动保存，重新打开文件、重启 Obsidian 后自动恢复；增删表格行不影响已保存的宽度；文件删除 / 重命名时自动清理或迁移对应记忆
• 清除列宽：命令面板一键清除当前文件所有表格的已保存列宽
• 自动适配列宽：一键让当前文件所有表格按内容自动调整列宽，长文本单行显示；重复点击结果恒定不外扩；左侧功能区图标 / 命令面板 / 设置页按钮三种触发方式
• 自适应铺开：列宽按比例换算为百分比，表格始终铺满页面并跟随窗口动态缩放，无横向滚动条（窄页面内容自动换行）；设置中可切换固定像素模式（默认自适应）
• 表格布局：fixed（固定列宽，推荐）/ auto（自动列宽），表格宽度支持 100% / 像素值
• 单元格排版：垂直对齐（上 / 中 / 下）与行高调整
• 首列宽度：全局设置首列固定宽度（默认 200px），适合标签列
• 最小列宽：拖拽时的列宽下限保护（默认 40px）
• 双机同步友好：保存前自动合并磁盘最新数据，监听外部文件变化自动重载，避免多设备同步时互相覆盖
• 实时生效：所有设置修改后立即应用，阅读视图与实时预览双视图支持

Features

• Header style: first row as header (on by default) and/or first column as header; headers are always bold, with an optional text color (empty = follow theme)
• Column width drag: hover the right edge of a header cell to grab the drag handle; drag to resize with a live pixel tooltip, or double-click the handle to enter an exact pixel value
• Width memory: each table's column widths are saved automatically and restored on reopen; adding or removing rows keeps saved widths intact; deleting or renaming a file cleans up or migrates its records
• Clear widths: one command clears all saved column widths in the current file
• Table layout: fixed (recommended) / auto, with table width (100% / pixel value)
• Cell layout: vertical alignment (top / middle / bottom) and line height
• First column width: global fixed width for label-style first columns (200px by default)
• Minimum column width: lower bound while dragging (40px by default)
• Auto-fit: one click fits every table in the current file to single-line content; repeated clicks are idempotent (no growth)
• Adaptive fill: stored widths are applied as percentages so tables always fill the page and resize with the window — no horizontal scrollbar (content wraps on narrow pages); switchable to fixed pixels (adaptive by default)
• Instant apply: settings apply immediately in both reading view and live preview

安装

方式一：从 Obsidian 社区目录安装（推荐）

1. 打开 Obsidian 设置 → 社区插件
2. 点击「浏览」，搜索 "XU Table Layout Helper"
3. 点击「安装」，然后「启用」

方式二：手动安装

1. 从 最新 Release 下载 main.js、manifest.json、styles.css 三个文件
2. 在 vault 中创建目录 .obsidian/plugins/table-layout-helper/
3. 将三个文件放入该目录
4. 打开 Obsidian 设置 → 社区插件，找到 XU Table Layout Helper 并开启

Installation

From Obsidian Community Directory:

1. Open Obsidian Settings → Community Plugins
2. Click "Browse" and search for "XU Table Layout Helper"
3. Click "Install", then "Enable"

Manual Installation:

1. Download main.js, manifest.json, styles.css from the latest release
2. Put them in <vault>/.obsidian/plugins/table-layout-helper/
3. Enable in Settings → Community Plugins

使用方法

1. 将鼠标悬停到表头单元格的右边缘，出现高亮竖条后按住拖动
2. 双击拖拽手柄，输入精确像素值后回车或点击「应用」
3. 松开鼠标即自动保存，重新打开文件后宽度自动恢复
4. 需要恢复某文件全部表格的默认宽度时，命令面板执行「清除本文件的表格列宽」

Usage

1. Hover the right edge of a header cell until the highlight bar appears, then drag
2. Double-click the handle to type an exact pixel width, press Enter or click Apply
3. Widths save on mouse release and restore automatically on reopen
4. Run "Clear table column widths in this file" from the command palette to reset the current file

设置说明

命令列表

技术说明

• 纯 JavaScript 实现（main.js），无需编译；main.ts 为 TypeScript 参考
• 运行时样式通过动态注入 <style> 应用，依靠选择器特异性覆盖主题（不使用 !important）；仅自动适配列宽的临时测量阶段通过内联样式临时压制换行（覆盖 Obsidian 内部链接的断行设置），测量结束即还原
• 列宽指纹 = 文件路径 + 列数 + 表头哈希 + 首行数据哈希（不含行号），存于插件自身 data.json，不修改笔记内容；旧版含行号的 key 首次加载时自动迁移
• 拖拽仅在拖动期间挂载 document 级监听，松手即卸载；无轮询、无全库扫描
• 不使用 Node/Electron API，支持移动端（isDesktopOnly: false）

许可证

MIT License - Copyright (c) 2026 旭说