dsh-markdown-notes

使用

阅读、编辑和管理文档

• 文档栏顶部「新建」直接创建笔记并进入编辑。
• 单击文档打开阅读，点击右上角「编辑」修改；编辑时可切换源码和并排视图。
• 并排模式下，滚动任意一侧会同步另一侧。通过源码行与正文块的位置对应，适应代码、公式和图片造成的高度差；图片和图表加载后保留当前阅读位置。
• 点击顶部文档名称可以改名；删除、另存为、导入等操作位于「…」菜单。
• 删除需要确认，确认后直接删除磁盘文件，不进入回收站。
• 文件被其他编辑器修改时，插件会提示冲突并保留草稿，可使用「草稿另存为」。

保存位置与自动迁移

默认位置由 DSH 官方 @deepseek-ai/dsh-home-paths 路径库解析，位于 DSH 数据根目录下。例如未设置 DSH_HOME 时：

%USERPROFILE%\.dsh\plugin-data\dsh-markdown-notes\notes

在「… → 保存位置」中选择文件夹或输入绝对路径，点击「迁移并使用」：

1. 保存当前草稿，检查新旧目录和同名冲突。
2. 保持子目录结构，复制普通 .md 笔记与初始化标记，并重建空文件夹。
3. 保存新路径，再清理已成功迁移的旧文件。
4. 清理迁移后的空文件夹；旧目录中还有无关文件或迁移期间被外部修改的文件时，保留并提示。

迁移不会覆盖目标目录中的同名文档。复制或配置保存失败时，原文件保留。新旧目录不能互为父子目录，也不能是磁盘根目录、用户主目录或目录链接。

文件夹创建、重命名、移动笔记和迁移的详细说明见 多级文件夹。

新路径保存在 $DSH_HOME/plugin-data/dsh-markdown-notes/settings.json（默认 %USERPROFILE%\.dsh\plugin-data\dsh-markdown-notes\settings.json），重启后继续生效。插件的 directory 配置项仅作为首次使用时的初始目录；之后请通过界面迁移。设置文件留在插件数据目录，迁移只移动笔记内容。

plugin-data/dsh-markdown-notes 是本插件在 DSH 数据根目录中使用的独立子目录，普通 Markdown 文件仍由插件读写，不转为 DSH 的 KV 存储格式。所有工作区共用这套笔记。当前仍在开发阶段，本版本不读取或迁移旧的 .dsh-markdown-notes 设置及 Documents/DSH Notes 数据，也不包含旧版兼容逻辑。

导入 Markdown

将 UTF-8 编码的 .md / .markdown 文件拖到笔记页面，或选择「… → 导入 Markdown」。文件会复制到笔记目录，原文件不变；同名文档会添加 (2) 等后缀。

每批最多 20 篇、合计 20 MB，单篇最大 2 MB。直接放入目录的 Markdown 文件，可通过「… → 刷新列表」加载。

默认示例

首次使用会创建 Markdown 内容示例.md，展示常见及扩展语法。同名文件已存在时不覆盖；示例可自由编辑、改名或删除。删除后不会反复生成。

示例改编自 Doocs Markdown 编辑器的示例文档，已移除结语后的推荐阅读和二维码。原文中关于微信公众号菜单、公式编辑器等其他产品的说明仅作为文章保留，不代表本插件提供对应功能。来源与许可见 第三方说明。

“链接与图片”示例指向 Wanyi424 的 GitHub 主页，图片使用本项目生成的 DSH Markdown Notes 宣传图。升级不会覆盖已经创建或修改过的笔记，可从 src/assets/sample.md 重新导入最新示例。

打开资源管理器

「… → 在资源管理器打开」读取宿主端当前笔记目录，并调用 DSH 原生的应用打开接口，不再自行启动隐藏的 explorer.exe 进程。原生接口返回失败时会显示错误。

笔记请求会核对界面与宿主的版本。如果提示“前后端版本不一致”，请核对安装包和插件列表，完整退出并重新启动 DSH；若仍失败，反馈提示中的两个版本号和具体错误。