概览
dsh-composer-markdown
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **列表标记样式与反引号隐藏均为编辑态视觉层**:字符本身仍在草稿/复制/发送文本中;选区覆盖时恢复原始字样与字宽。无序圆点与原横线的字宽不完全一致(圆点用等宽字体 `::after`),极端窄列下可能比原 `- ` 略宽,属可接受的排版差异。 - **纵向归位有短暂瞬态**:↑/↓ 落入标记内部后,驱逐发生在随后的 restyle 扫描(微任务级),极端情况下可能见到一帧内部位置;←/→ 按键期仲裁无此瞬态。 - **代码块语言标识不可直接编辑**(标记行不可达):修改语言 = 一次 Backspace 解包(保留正文)后重敲围栏。 - 未闭合的 ```` ``` ```` 一律不渲染(含粘贴/草稿恢复出的),在标记行上按 Shift+Enter(或补上闭合 ```` ``` ````)即成块。 - `` `` ``/```` ``x`` ```` 等多重反引号定界不识别(朴素两两配对)。 - 有序列表规整按现状重写一切非连续序号:手动跳号/非 1 起始会回弹;更深缩进的行只挂起外层组(空行、围栏、缩进不深于本组的普通行/无序行仍断组);同一组超过 9 位序号(≥10 亿行)不适用。 - **层级阶梯的子树边界按「更深缩进」判定**:空行、围栏区域、缩进不深于该项的行都终止子树(与规整分组的边界语义一致);空行后的深层缩进行不算前项的子层级,不会被联动平移。 - **降级上限(v2.9)**:父级 = 上方最近的列表项行(普通文本行跳过不算,空行/围栏区域隔断查找);项最多处于父级下一级(父级缩进 +2)。已达上限的项与列表首项按 Tab 是「认领但不动」的空操作——不会无限降级,也不会因此让焦点跳出输入框;要再深一级,须先让其父级(或上方兄弟)先降级。升级方向无上限(0 级为自然下限)。 - **取消列表(顶层升级)会隔断有序组**:留下的普通行使下方同缩进成员按不变式从 `1.` 重起——这是既定编号契约的直接后果,非 bug。v2.8 起该手势取代了旧的「有序项退格合并进上一行」行为。 - 缩进/前缀原子的「不可选中、不可删除」为**稳态键盘体验**:折叠光标无法进入原子内部(方向键跨越、越界驱逐、行首 Delete 整体删除);拖拽/Ctrl+A 等范围选区仍可覆盖原子字符(与序号手动改号的「所选即所见」规则一致),此时原生删除可用。 - 行内代码内容若恰为 lexicon 中的 `/name`、`@name` 文本引用 token,样式可能被 chip 着色覆盖(文本内容不受影响)。 - 引用 chip(`@xxx`)内部含换行时无法在其上提升软行(chip 为原子节点);这类行的围栏判定退化为整段判定。 - 完全无显形的行内代码方案需 chip 节点(技术文档路线 B,留作后续演进)。
