{"id":19973874,"url":"https://github.com/zmister2016/obsidian-mrdoc","last_synced_at":"2025-05-04T02:32:18.353Z","repository":{"id":215626315,"uuid":"719367813","full_name":"zmister2016/obsidian-mrdoc","owner":"zmister2016","description":"一个 Obsidian 的 MrDoc 插件，用于 Obsidian 本地文档与 MrDoc 的双向同步","archived":false,"fork":false,"pushed_at":"2025-04-23T03:12:05.000Z","size":88,"stargazers_count":3,"open_issues_count":2,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-23T04:23:25.696Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zmister2016.png","metadata":{"files":{"readme":"README-zh.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-16T02:31:11.000Z","updated_at":"2025-04-23T03:11:49.000Z","dependencies_parsed_at":"2024-04-27T15:25:45.248Z","dependency_job_id":"e4611d23-766c-4605-a2c1-3574bc32accf","html_url":"https://github.com/zmister2016/obsidian-mrdoc","commit_stats":null,"previous_names":["zmister2016/obsidian-mrdoc-plugin","zmister2016/ob-mrdoc"],"tags_count":7,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmister2016%2Fobsidian-mrdoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmister2016%2Fobsidian-mrdoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmister2016%2Fobsidian-mrdoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmister2016%2Fobsidian-mrdoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zmister2016","download_url":"https://codeload.github.com/zmister2016/obsidian-mrdoc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252279037,"owners_count":21722820,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T03:13:15.567Z","updated_at":"2025-05-04T02:32:17.927Z","avatar_url":"https://github.com/zmister2016.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"一个实现 Obsidian 与觅思文档之间文档同步的插件。\n\n- 为 Obsidian 用户提供了一个本地文档远程同步的新方案；\n- 为 Obsidian 本地文档提供了一个 Web 在线浏览文档的新方案；\n- 为觅思文档用户提供了一个离线编写、保存和同步文档的新方案；\n\n## 系统要求\n\n- 觅思文档专业版`v1.3.6+`、觅思文档开源版`v0.9.2+`\n- Obsidian`v1.4.16+`\n\n## 基本概念的对应关系\n\n- Obsidian 的「仓库（Vault）」，对应于觅思文档的「文集」；\n- Obsidian 仓库内的「Markdown 文件」，对应于觅思文档中的「文档」；\n- Obsidian 仓库内的「文件夹」对应于觅思文档中包含下级文档的「文档」；\n\n## 插件规则\n\n### 仓库（Vault）\n\nObsidian 需要在插件的设置页面选择对应觅思文档的目标文集。\n\u003e 如果希望文档同步到一个新的觅思文档文集，可点击「新建」按钮新建一个文集后选择。\n\n### 拉取远程文档\n\n插件在左侧工具栏上添加了一个功能图标按钮，用于从觅思文档上拉取文集内所有文档到 Obsidian 本地。点击拉取操作后，插件会获取已指定文集内所有文档的信息并准备写入到 Obsidian 本地。\n\n- 如果本地不存在同名的文件/文件夹，则新建文件/文件夹；\n- 如果本地已存在同名的文件，判断本地文件是否与远程文档存在映射关系：\n\t- 如果存在映射关系，比对本地文件和远程文档的最后修改时间：\n\t\t- 如果本地文件最后修改时间新于远程文档，跳过；\n\t\t- 如果本地文件最后修改时间旧于远程文档，将远程文档的内容覆盖写入本地文件。\n\t- 如果不存在映射关系，跳过。\n- 如果本地已存在同名文件夹，跳过。\n\n### 新建文件/文件夹\n\nObsidian 本地新建文件/文件夹，会自动在觅思文档指定的文集中创建一个文档，并在插件内维护一个本地文档与远程文档的映射关系；\n\n### 重命名文件/文件夹\n\n在 Obsidian 本地对文件/文件夹进行重命名，会自动修改觅思文档上对应的文档标题。\n\n### 修改文件\n\n修改文件内容后，你可以在编辑器右上角的「更多选项」中点击「同步至 MrDoc」菜单将文档的更新推送到觅思文档。\n\n你也可以在 Obsidian 软件的左侧文件列表中，鼠标停留在指定的文档上，点击鼠标右键，唤出上下文菜单后，点击「同步至 MrDoc」菜单将文档的更新推送到觅思文档。\n\n除此之外，插件提供了一个**实时推送**的选项，你可以在插件的设置页面开启「实时更新文档内容」，这样，当你在 Obsidian 中修改了文件内容，插件会实时将最新的文件内容更新到觅思文档上。\n\n### 删除文件/文件夹\n\n如果 Obsidian 本地的文件/文件夹与觅思文档建立了映射关系，那么在本地删除文件/文件夹，插件也会同步将觅思文档内的文档进行删除（软删除，文档进入回收站）。\n\n### 图片处理\n\n对于图片的处理，插件提供了两个选项：\n\n- 转存本地图片\n- 转存粘贴板中的图片\n\n**1、转存本地图片**\n\n当你粘贴或拖拽本地图片到 Obsidian 编辑器内时，插件会将图片上传至觅思文档，然后返回觅思文档的图片链接地址并填入 Obsidian 编辑器。\n\n**2、转存粘贴板中的图片**\n\n当你在别处复制了文本要粘贴到 Obsidian 编辑器内时，插件会提取其中的图片链接，并将其上传至觅思文档，然后返回觅思文档的图片链接地址替换掉原文本中的图片链接。\n\n### 重置映射关系\n\n在 Obsidian 本地文件于觅思文档的文档建立了映射关系后，如果你需要接触其绑定的映射关系，可以在插件的设置页面点击「重置文档映射」，这样，对 Obsidian 本地文件的操作将不会同步至觅思文档。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmister2016%2Fobsidian-mrdoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzmister2016%2Fobsidian-mrdoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmister2016%2Fobsidian-mrdoc/lists"}