Obsidian 插件:Note Refactor
插件名片
概述
把笔记内容提取到新的笔记中并分割笔记
原文出处
下面自述文件的来源于 Readme
Readme(翻译)
下面是 note-refactor-obsidian 插件的自述翻译
注意重构
该存储库包含一个用于 Obsidian 的插件,用于将选定的部分提取到新的笔记中。
默认的快捷键为:
快捷键 | 动作 |
---|---|
Ctrl/Cmd + Shift + N | 提取选定内容到新笔记 - 第一行作为文件名: 将选定内容复制到新笔记中,第一行作为文件名,并替换为链接。 |
Ctrl/Cmd + Shift + C | 提取选定内容到新笔记 - 仅内容: 将选定内容复制到新笔记中,提示输入文件名,并替换为链接。 |
:warning: 为了避免意外操作,笔记拆分命令的快捷键默认未设置。
新的笔记文件将在存储库的根目录下创建,文件名为选定文本的第一行,内容为选定文本的其余部分。
文件名中的标题字符(#
)和其他非法字符,包括 :
、\
、/
,将被删除。
用法
此表格显示了此插件的不同用例以及在每种情况下如何使用命令和设置。
提取
用例 | 命令 | 插件设置 | |
---|---|---|---|
1 | 1. 将选择内容完全提取到一个新的笔记中。 2. 新笔记的文件名由用户提供。 | 提取选择到新笔记 - 仅内容 | 包括标题 False |
2 | 1. 将选择内容完全提取到一个新的笔记中。 2. 新笔记的文件名由选择的第一行设置。 | 提取选择到新笔记 - 第一行作为文件名 | 排除第一行 False 包括标题 False |
3 | 1. 将选择内容提取到一个新的笔记中。 2. 新笔记的文件名由选择的第一行设置。 3. 新笔记中包括第一行作为标题。 | 提取选择到新笔记 - 第一行作为文件名 | 排除第一行 False 包括标题 True |
4 | 1. 将选择内容提取到一个新的笔记中。 2. 新笔记的文件名由选择的第一行设置。 3. 新笔记中不包括第一行。 | 提取选择到新笔记 - 第一行作为文件名 | 排除第一行 True |
5 | 1. 将选择内容完全提取到一个新的笔记中。 2. 新笔记的文件名由文件名前缀设置生成。 | 提取选择到新笔记 - 仅前缀作为文件名 |
分割
用例 | 命令 | 插件设置 | |
---|---|---|---|
1 | 1. 将光标所在行的内容拆分为新的笔记,保持原样。 2. 新笔记的文件名由用户提供。 | 仅拆分笔记内容 | 包括标题 False |
2 | 1. 将光标所在行的内容拆分为新的笔记。 2. 新笔记的文件名由用户提供。 3. 将第一行作为新笔记的标题。 | 仅拆分笔记内容 | 包括标题 True |
3 | 1. 将光标所在行的内容拆分为新的笔记,保持原样。 2. 新笔记的文件名从所选内容的第一行设置。 | 以光标位置拆分笔记 - 第一行作为文件名 | 包括标题 False |
4 | 1. 将光标所在行的内容拆分为新的笔记。 2. 新笔记的文件名从所选内容的第一行设置。 3. 将第一行作为新笔记的标题。 | 以光标位置拆分笔记 - 第一行作为文件名 | 排除第一行 False 包括标题 True |
5 | 1. 将带有标题的内容拆分为每个标题下的新笔记。 2. 每个新笔记的文件名从标题中设置。 | 以标题拆分笔记 - H1 以标题拆分笔记 - H2 以标题拆分笔记 - H3 |
命令
分割笔记
将当前行的当前笔记分割成一个新的笔记或追加到现有笔记中。
在此处拆分 - 将当前行作为笔记文件名
此命令将当前笔记从当前行拆分为一个新的笔记,并将当前行作为新笔记的文件名。
在此处拆分注释 - 仅内容
此命令将当前注释拆分为一个新注释,或者将其附加到现有注释中,从当前行开始。用户将被提示输入新注释的文件名。
按标题拆分笔记 - H1、H2、H3
该命令将当前笔记按所选级别的每个标题(H1、H2 或 H3)拆分为一个新的笔记,并使用标题作为每个新笔记的文件名。
提取选择
将当前选择提取到一个新的笔记中或追加到现有笔记中。
将选择内容提取到新笔记或附加到现有笔记 - 使用第一行作为文件名
此命令将选定的文本复制到新笔记的内容中,使用第一行作为新笔记的文件名,或附加到现有笔记中。
将选择内容提取到新笔记或追加到现有笔记 - 仅内容
此命令仅将所选文本复制到新笔记的内容中,或追加到现有笔记中。用户将被提示输入新笔记的文件名。
将所选内容提取到新的笔记中 - 仅作为文件名前缀
此命令仅将所选文本复制到新笔记的内容中,或追加到现有笔记中。文件名根据文件名前缀设置的值自动生成。新笔记将在后台创建,不会在新窗格中显示。
配置
新笔记的默认保存位置
新笔记的保存位置可以作为插件配置设置,与 Obsidian 核心的“新笔记的默认保存位置”设置保持一致。
有 3 个选项可供选择:
- Vault 文件夹
- 与当前文件相同的文件夹
- 指定的文件夹
指定的文件夹选项允许您指定一个包含多个日期时间格式的文件夹路径。
示例
设置为 Zettels/{{date:YYYY}}/{{date:MMMM}}
的文件夹路径将在以下文件夹结构中添加一个新文件:
- [Vault]
- Zettels
- 2020
- October
- 2020
- Zettels
文件名前缀
文件名前缀选项允许您为新笔记指定一个前缀,该前缀可以包含多个日期时间格式。
示例
设置为 {{date:YYYYMMDDHHmm}}-
的前缀将添加一个具有以下文件名的新文件:
202010311425-我的新笔记
默认情况下进行转录
此配置设置意味着通过任何提取或笔记拆分命令创建的新笔记的所有插入的内部链接将被添加为转录/笔记嵌入 ![[new note]]
,而不是链接 [[new note]]
。
第一行作为注释标题
此配置设置允许将所选文本的第一行作为新注释内容的标题,标题格式可配置为 #
、##
、###
等。
此设置适用于“仅首行文件名”或“仅内容”命令。
笔记链接模板
此设置用于设置生成链接到提取的笔记的内容的模板。这将覆盖默认的默认转录设置。
当插件命令被执行时,将支持以下占位符,并将其替换为动态值:
{{date}}
当前日期,还支持日期和时间格式,如YYYYMMDD
和HH:mm
。{{title}}
原始笔记的标题。{{new_note_title}}
新笔记的标题。{{new_note_content}}
用于新笔记的重构内容。
重构笔记模板
此设置用于设置生成重构笔记内容的模板。
当插件命令被执行时,以下占位符将被支持并替换为动态值:
{{date}}
当前日期,也支持日期和时间格式,如YYYYMMDD
和HH:mm
。{{title}}
原始笔记的标题。{{new_note_title}}
新笔记的标题。{{new_note_content}}
重构后的新笔记内容。
兼容性
自定义插件仅适用于 Obsidian v0.9.7+。
此存储库的当前 API 目标为 Obsidian v0.9.10。
安装
从 Obsidian 的 0.9.7 版本开始,可以直接在应用程序内安装此插件。该插件可以在“设置”窗格下的第三方插件中找到,该窗格可以从“设置”窗格下的“社区插件”目录中访问。
手动安装
- 下载 最新版本
- 从压缩包中提取 note-refactor-obsidian 文件夹到你的 vault 的插件文件夹:
<vault>/.obsidian/plugins/
注意:在某些机器上,.obsidian
文件夹可能是隐藏的。在 MacOS 上,你可以按下Command+Shift+Dot
来在 Finder 中显示该文件夹。 - 重新加载 Obsidian
- 如果提示安全模式,你可以禁用安全模式并启用插件。
会检查是否覆盖现有文件,但是…
💥 请先在测试vault中尝试,并确保备份! 💥
鸣谢
感谢 MrJackphil,本插件基于他创建的 代码片段。
对于开发者
欢迎并感谢您的 Pull requests。😀
如果您想为该插件的开发做出贡献,请按照 CONTRIBUTING.md 中提供的指南进行操作。
捐赠
此插件免费提供。如果您想向我捐赠一些东西,可以通过 PayPal 进行捐赠。谢谢!
反馈交流
其他渠道
版权声明
版权声明:所有 PKMer 文章如果需要转载,请附上原文出处链接。