Repository navigation
Releases
3.4.2
Fold name[options] inside code blocks into a clickable tag — expand it when you need the details, or switch to a hover popup that lists every option with its comment.
3.4.2 变更
- 标注为仅桌面端(
isDesktopOnly: true)。插件本身没有用到桌面专属 API,但没有在移动端实测过,
与其对外声称支持、让用户踩坑,不如先如实标注。将来实测通过后改回false即可。
3.4.1 变更
- 插件显示名改为 Code Block Parameter Fold,
description改为英文,为提交社区列表做准备。 id(code-block-context-fold)保持不变,已装实例、设置和折叠记录都不受影响;界面文案仍跟随 Obsidian 的语言。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示带下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
选项格式
一行一个选项,// 之后是注释:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
_ 不需要转义,_MainTex_ST、UNITY_OBJECT_TO_WORLD 这些名字可以直接写。[ ] 仍是结构字符。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键折叠。 - 想批量录入选项:右键 → 插入参数选项,填名称、逐个加「选项 + 注释」,保存。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 折叠多了想盘点:命令面板 → 打开折叠总览(支持搜索)。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载
manifest.json、main.js、styles.css(或code-block-context-fold-3.4.1.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用 Code Block Parameter Fold。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 两个内容完全相同的代码块会被按出现顺序各自对应。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
3.4.1
Fold name[options] inside code blocks into a clickable tag — expand it when you need the details, or switch to a hover popup that lists every option with its comment.
3.4.1 变更
- 插件显示名改为 Code Block Parameter Fold,
description改为英文,为提交社区列表做准备。 id(code-block-context-fold)保持不变,已装实例、设置和折叠记录都不受影响;界面文案仍跟随 Obsidian 的语言。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示带下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
选项格式
一行一个选项,// 之后是注释:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
_ 不需要转义,_MainTex_ST、UNITY_OBJECT_TO_WORLD 这些名字可以直接写。[ ] 仍是结构字符。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键折叠。 - 想批量录入选项:右键 → 插入参数选项,填名称、逐个加「选项 + 注释」,保存。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 折叠多了想盘点:命令面板 → 打开折叠总览(支持搜索)。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载
manifest.json、main.js、styles.css(或code-block-context-fold-3.4.1.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用 Code Block Parameter Fold。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 两个内容完全相同的代码块会被按出现顺序各自对应。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
3.4.0
Fold name[options] inside code blocks into a clickable tag — expand it when you need the details, or switch to a hover popup that lists every option with its comment.
3.4.0 新增
- 界面中英双语:跟随 Obsidian 的语言设置,英文界面下菜单、命令、通知、设置页和总览全部是英文;其他语言回退英文。
- 报错文案也随语言变化,同时保留了稳定的错误码,脚本和自动化判断不受影响。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示带下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
选项格式
一行一个选项,// 之后是注释:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
_ 不需要转义,_MainTex_ST、UNITY_OBJECT_TO_WORLD 这些名字可以直接写。[ ] 仍是结构字符。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键折叠。 - 想批量录入选项:右键 → 插入参数选项,填名称、逐个加「选项 + 注释」,保存。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 折叠多了想盘点:命令面板 → 打开折叠总览(支持搜索)。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载
manifest.json、main.js、styles.css(或code-block-context-fold-3.4.0.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 两个内容完全相同的代码块会被按出现顺序各自对应。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
3.3.0
把代码块里的 参数[一堆选项] 折叠成标签,需要的时候再展开——写 Shader 指令、引擎配置、命令行开关、枚举值这类“名字 + 一长串可选值”的内容时,能让笔记干净很多。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示蓝色下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
3.3.0 新增
- 折叠总览支持搜索:按标签、选项内容或笔记名过滤,大小写不敏感;搜到笔记名时会列出该笔记的全部折叠。有搜索词时按 Esc 先清空搜索,再按一次才关弹窗。
- 设置页:选新折叠的默认形态(普通折叠 / 选项悬浮弹窗),也可以关掉阅读视图的折叠。
- 折叠总览:按笔记分组列出整个库的折叠,点笔记名直接跳过去,逐条删除,还能一键清理指向已删除笔记的失效记录。入口有三处:设置页里的按钮、左侧栏图标、命令面板「打开折叠总览」。
选项格式
一行一个选项,// 之后是注释:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
_ 不需要转义,_MainTex_ST、UNITY_OBJECT_TO_WORLD 这些名字可以直接写。[ ] 仍是结构字符。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键 → 折叠选中参数。 - 想批量录入选项:右键 → 插入参数选项…,填名称、逐个加「选项 + 注释」,保存。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 折叠多了想盘点:命令面板 → 打开折叠总览。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载下面的
manifest.json、main.js、styles.css(或code-block-context-fold-3.3.0.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 两个内容完全相同的代码块会被按出现顺序各自对应。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
3.2.0
把代码块里的 参数[一堆选项] 折叠成标签,需要的时候再展开——写 Shader 指令、引擎配置、命令行开关、枚举值这类“名字 + 一长串可选值”的内容时,能让笔记干净很多。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示蓝色下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
3.2.0 新增
- 设置页:可以选新折叠的默认形态(普通折叠 / 选项悬浮弹窗),也可以关掉阅读视图的折叠。
- 折叠总览:按笔记分组列出整个库的折叠,点笔记名直接跳过去,逐条删除,还能一键清理指向已删除笔记的失效记录。入口有三处:设置页里的按钮、左侧栏图标、命令面板「打开折叠总览」。
选项格式
一行一个选项,// 之后是注释:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
_ 不需要转义,_MainTex_ST、UNITY_OBJECT_TO_WORLD 这些名字可以直接写。[ ] 仍是结构字符。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键 → 折叠选中参数。 - 想批量录入选项:右键 → 插入参数选项…,填名称、逐个加「选项 + 注释」,保存。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 折叠多了想盘点:命令面板 → 打开折叠总览。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载下面的
manifest.json、main.js、styles.css(或code-block-context-fold-3.2.0.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 两个内容完全相同的代码块会被按出现顺序各自对应。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
3.1.0
把代码块里的 参数[一堆选项] 折叠成标签,需要的时候再展开——写 Shader 指令、引擎配置、命令行开关、枚举值这类“名字 + 一长串可选值”的内容时,能让笔记干净很多。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示蓝色下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
3.1.0 新增
- 阅读视图改用和编辑视图同一套锚点定位。以前只认原文一字不差,笔记里改了某个选项,阅读视图里那一段就不折了;现在会像编辑视图一样按语言、代码块位置、行号和上下文重新找回,只有真的分不清时才放弃。
- 每次渲染按文件读一次源码并缓存,文件改动或重命名时自动失效,不会读到旧内容。
选项格式
一行一个选项,// 之后是注释:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
_ 不再需要转义,_MainTex_ST、UNITY_OBJECT_TO_WORLD 这些名字可以直接写。[ ] 仍是结构字符。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键 → 折叠选中参数。 - 想批量录入选项:右键 → 插入参数选项…,填名称、逐个加「选项 + 注释」,保存。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 命令面板里也有「折叠选中的参数内容」「取消光标处的参数折叠」。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载下面的
manifest.json、main.js、styles.css(或code-block-context-fold-3.1.0.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 两个内容完全相同的代码块会被按出现顺序各自对应;如果你希望精确到具体块,给它们加上不同的语言标注会更稳。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
3.0.0
把代码块里的 参数[一堆选项] 折叠成标签,需要的时候再展开——写 Shader 指令、引擎配置、命令行开关、枚举值这类“名字 + 一长串可选值”的内容时,能让笔记干净很多。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示蓝色下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
3.0.0:选项格式改了
选项之间不再用 _ 分隔,改成一行一个:
混合模式[
Normal//正常混合
Add//相加,越高越亮
]
好处是 _ 彻底解放了——_MainTex、UNITY_OBJECT_TO_WORLD、_Time.y 这些名字可以直接写进参数名、选项名和注释,不用再躲避。// 仍然是注释起点,[ ] 仍然是结构字符。
升级说明:这是破坏性变更,2.x 用「插入参数选项」面板生成过的内容需要转换一次:
node scripts/migrate-legacy-format.mjs --vault "<你的库>" --apply不带 --apply 时只预演、不写盘;写入前会给笔记和 data.json 各留一份 .bak-<时间戳> 备份。手写的单行 A[a/b/c] 不受影响,不会被改写。
怎么用
- 在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键 → 折叠选中参数。 - 想批量录入选项:右键 → 插入参数选项…,填名称、逐个加「选项 + 注释」,保存即可生成上面的格式。
- 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
- 命令面板里也有「折叠选中的参数内容」「取消光标处的参数折叠」。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载下面的
manifest.json、main.js、styles.css(或code-block-context-fold-3.0.0.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 阅读视图按记录里保存的原文精确匹配;如果笔记内容改过、编辑视图还没重新打开同步记录,那一段会保持原样。
- 方括号
[ ]不能出现在参数名、选项名或注释里。 - 笔记改动后靠锚点重新定位;同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。
2.7.0
把代码块里的 参数[一堆选项] 折叠成标签,需要的时候再展开——写 Shader 指令、引擎配置、命令行开关、枚举值这类“名字 + 一长串可选值”的内容时,能让笔记干净很多。
两种显示方式
- 普通折叠:
Cull 选项[back/Front/Off]只显示蓝色下划线的Cull 选项,[内容]收起来,点一下展开。 - 选项悬浮弹窗:折叠成药丸状的
Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。
2.7.0 新增
- 阅读视图和导出 PDF 也能折叠了。此前只有编辑视图生效,切到阅读视图或导出时参数会摊开;现在两边一致,标签在阅读视图里同样可以点击展开。
- 选项药丸的结构、样式与悬浮交互抽成共用模块,编辑器与阅读视图不会再出现两套行为不一致的情况。
- 仓库更名为
code-block-context-fold,与插件 id 对齐。
怎么用
-
在一个代码块里选中完整的
参数[内容](支持多行、支持嵌套方括号),右键 → 折叠选中参数。 -
想批量录入选项:右键 → 插入参数选项…,填名称、逐个加「选项 + 注释」,保存即可生成:
混合模式[ Normal//正常混合_ Add//相加,越高越亮 ] -
在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
-
命令面板里也有「折叠选中的参数内容」「取消光标处的参数折叠」。
折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。
安装
- 下载下面的
manifest.json、main.js、styles.css(或code-block-context-fold-2.7.0.zip解压)。 - 放到
<你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。 - 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。
插件不绑定任何库,每个库各自保存自己的折叠记录。
已知限制
- 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
- 阅读视图按记录里保存的原文精确匹配;如果笔记内容改过、编辑视图还没重新打开同步记录,那一段会保持原样。
_与[ ]是结构字符,不能出现在参数名、选项名或注释里。- 笔记改动后靠锚点重新定位;同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。
许可证
GPL-3.0-or-later。