update at 2025-09-22 18:54:59

README.md

@@ -300,6 +300,94 @@ NoteToMP插件支持该语法。
 ### 插入SVG图标
 https://www.bilibili.com/video/BV15XWVeEEJa/
 
+### Gallery 短代码支持
+
+自 1.x 版本起，插件支持将形如 Hugo/Hexo 风格的短代码：
+
+```
+{{<gallery dir="/img/guanzhan/1" figcaption="毕业展"/>}}{{<load-photoswipe>}}
+```
+
+在渲染阶段自动展开为若干行图片 WikiLink：
+
+```
+![[001.jpg]]
+![[002.jpg]]
+```
+
+配置项：
+
+- Gallery 根路径（galleryPrePath）：指向本地实际图片根目录，用于拼接短代码中的 dir 得到真实磁盘路径。
+- Gallery 选取图片数（galleryNumPic）：每个 gallery 最多展开前 N 张图片（按文件名排序）。
+
+可在插件设置界面直接修改，无需重启。若希望随机选取或按时间排序，可后续在 issue 中反馈需求。
+
+### Gallery 块与 figure 支持
+
+除了带 dir 的短代码，还支持块级：
+
+```
+{{<gallery>}}
+{{<figure src="/img/a.jpg" caption="说明" >}}
+{{<figure link="/img/b.png" caption="说明" >}}
+{{</gallery>}}
+```
+
+渲染为：
+
+```
+![[a.jpg]]
+![[b.png]]
+```
+
+说明：
+- 支持 `src` 或 `link` 属性任选其一。
+- `caption` 当前忽略（可后续增强：写入 `![[file|caption]]` 或紧随段落）。
+- 去重/排序策略：按出现顺序，文件名原样。
+
+### 自定义行级语法扩展
+
+为提升公众号排版效率，插件内置以下“轻语法”转换（发生在 Markdown 解析前）：
+
+1. 斜体标注：`[fig 一段说明 /]` → `<span style="font-style:italic;...">一段说明</span>`
+2. 彩色提示块（只作用当前这一行，不跨行）：
+    - `|| 内容` 默认灰底
+    - `||r 内容` 棕底白字
+    - `||g 内容` 黄绿色背景
+    - `||b 内容` 浅灰背景
+    - `||y 内容` 浅黄背景
+
+这些语法不会写回原笔记，只影响发布预览。后续可加入：类名替换 + 主题化配置 + caption 支持，欢迎反馈需求。
+
+### 无图片时的默认封面
+
+自动封面选择优先级：
+1. frontmatter: cover / image（非空）
+2. 正文首图（Markdown 或 WikiLink）
+3. Gallery 短代码 / 块展开得到的首图
+4. 默认封面 `defaultCoverPic`（设置面板可配置，默认 `cover.png`）
+
+配置说明：
+- 若填写文件名（如 `cover.png`），会按当前笔记目录解析并包装为 `![[cover.png]]`。
+- 若填写完整 `![[xxx]]` 语法或 `http(s)://` URL，将原样使用。
+- 若文件不存在，不会报错（可后续增加存在性提示）。
+
+### Frontmatter 解析回退
+
+如果 Obsidian `metadataCache` 暂未命中（例如首次载入或缓存延迟），插件会手动对首段 `---` YAML 进行轻量行级解析，提取：
+- title / author / cover(image)
+
+避免因为缓存未就绪导致标题/作者缺失。若需复杂 YAML（数组、多行字符串）建议等待官方缓存，或后续考虑引入完整 YAML 解析库。
+
+### 调试日志
+
+在控制台（开发者工具）可看到：
+```
+[note2mp] active file path: your/file/path.md
+[note2mp] use default cover: cover.png -> ![[cover.png]]
+```
+路径日志做了节流：同一文件 3 秒内不重复打印。后续可加“调试开关”以完全关闭。
+
 ### 摘要、封面裁剪、原文链接等
 ```yaml
 ---