导出 md + assets 格式

[Kenshin]

描述

将当页面转换为 Markdown 并将其中的图片保存到本地，适合 Obsidian、Typora 用户使用。

地址

https://simpread.ksria.cn/plugins/details/BvjrJA6eh5

视频

2022-06-11_11-04-19.mp4

前提

此功能依赖于 同步助手 1.3.0 版 下载地址

Obsidian 用户

如果你是 Obsidian 用户，且在使用 导入到 Obsidian 插件 此功能也内置到了此插件中，可直接在此插件中使用 详细说明

使用

支持 手动导出 或 加入自动化时导出 详细说明

选项

随便进入一个页面 e.g. https://sspai.com/post/71576 并进入 阅读模式 → 右下角 → 动作 → 插件触发器

按照下图所示即可查看此插件的选项页。（注意：如果你的界面没有插件触发器，请根据此 解决方案 修复。

使用前提

此功能依赖于同步助手，所以需要确保

1. 在使用此功能前，需要已经安装并 绑定了同步助手

2. 确保你的同步助手是 1.3.0

设置目录

需要设置导入的目录后才能使用，支持两种设置方案

1️⃣ 同步助手增强导出 （首选方案）

你可以直接填入下面现成的内容

{"extension":"assets", "path":"/xxx/Obsidian/SimpRead"}

注意：上述语法来自 同步助手的增强导出 Mac 用户可以直接将 /xxx/Obsidian/SimpRead 替换为自己的路径

Windows 用户需要使用 \\ 方案

{"extension":"assets", "path":"C:\\Users\\***\\Documents\\***\\Desktop\\Documents"}

2️⃣ 导出 md + assets 格式设置

Mac 用户的路径 /xxx/Obsidian/SimpRead

Windows 用户路径 C:\\Users\\***\\Documents\\***\\Desktop\\Documents

但更建议使用 1️⃣ 方案，结合 type 语法规则，可以实现更灵活的导入方案

功能

1. 支持 Metadate 详细说明

   

2. 导出位置

   

3. 以 idx-title 的形式导出

   

4. 图片导出位置

   

5. 图片导出类型

   

快捷键

a t

关联

• 利用 Hazel 将 textbundle 修改为 Obsidian 可以预览的文件

• 巧用 Textbundle 格式让 Obsidian 更好的支持「包含图片子文件夹的 Markdown」

• 利用图床插件内置的 Cloudinary 图床解决个别网站无法转换图片的问题（进而解决无法使用 assets + md 方案或 Textbundle 方案的问题）

• 使用简悦提供的【离线下载辅助增强插件】与【图床插件】解决在导出时图片无法显示的问题

安装与升级

• 没有【使用同步助手 · 自动同步】的话，可通过 此链接 安装。

• 已经【使用同步助手 · 自动同步】的话，请使用 插件管理器 安装。

更新日志

1.1.3

• Optimize 优化转换为 base64 的算法，用于解决 [sspai.com](http://sspai.com) 无法转换的问题

• Optimize 优化设置界面到 2.0

1.1.2

• Add 新的字符，主要针对双链笔记用户去掉了一些特别字符，包括：[ ] # #5035

1.1.1

• Fix 修复非高级账户权限时导出异常问题。

1.1.0

此功能是 同步助手 1.1.3 增加的新功能，只能在 1.1.3 中使用。

• Add 图片导出位置 与 Typora 保存一直的四种类型。

• Add 图片导出类型，专门针对个别页面无法成功导出图片情况下，可使用 Base64 方案。

1.0.2

• Fix 当安装了 题图 插件并且使用 Live Editor 修改标题后，导入时仍使用旧标题的错误。

1.0.1

• Fix 当标题出现特殊字符时无法使用的错误。

1.0.0

• 快捷键 a e 支持

• 自定义 Metadata

• 设定导出目录

• 以 idx-title 的形式导出

[Kenshin]

Metadata 用法

Metadata 只能用于全文导出，且内置了如下占位符

占位符	描述
{{url}}	当前页面的 URL
{{title}}	当存在稍后读时为稍后读标题，否则为原网页标题
{{org_title}}	原网页标题
{{un_title}}	稍后读标题，不存在稍后读时为 untitled
{{desc}}	当前页面的描述
{{cover}}	当前页面的题图，没有的话用第一张图替代
{{note}}	当前稍后读的备注
{{date}}	导入到 Obsidian 的时间
{{timestamp}}	导入到 Obsdian 的时间戳
{{now|yyyyddmmHHMMss}}	日期格式化 详细说明
{{tags}}	如果当前文章是稍后读的话，为当前稍后读的标签
{{#|tag| }}	定制标签的前/后缀 详细说明

[Kohlenstoff1999]

在引用{{title}}前后有换行和空格
e.g.
模板：
title:: {{date}}-{{title}}
url:: {{url}}
Logseq中效果：
title:: 2023-11-01 12:12:36-

高手的合成研发逻辑，10 分推荐！

url:: https://mp.weixin.qq.com/s/4lfi-OA6HH2na0kJLAK8_w
询问一下如何变成以下效果？
title:: 2023-11-01 12:12:36-高手的合成研发逻辑，10 分推荐！
url:: https://mp.weixin.qq.com/s/4lfi-OA6HH2na0kJLAK8_w

[Kenshin]

暂时没有太好的方案，使用 Live Editor 手动去除标题的多余空行（把标题全部删除，然后再重新编写）

[Kenshin]

md + assets 格式

为什么要使用 md + assets 格式以及使用它们的优势是什么，简单的做了下介绍。

Markdown 的「问题」

Markdown 包含的是在线图片，当图片失效时就无法显示，所以简悦引入了 离线 Markdown 方案。

离线 Markdown

Markdown 可以包含离线图片，也就是将图片转为 Base64 编码形式，存储在 Markdown 中以防止图片 404 的方案，如下图所示

虽然避免了图片 404 问题，但因为 .md 过大会导致大部分 Markdown 都没法正常使用，我测试过：vs code、Obsidian、Typora 目前能较好的预览这种方式的只有 vs code。

Textbundle

同步助手 1.0.1 中引入了导出 .textbundle 格式，大部分 Markdown 都支持这种格式，如：Bear、FANotes（下图所示）

但更多的 Markdown 编辑器，如：Obsidian、Typora 均不支持此方式。

md + assets 格式

Obsidian、Typora 虽然不支持 .textbundle 格式，但它们支持 md + assets 格式，如下图所示

所以 同步助手 1.0.2 中引入了 md + assets 格式。

关联

• 利用图床插件内置的 Cloudinary 图床解决个别网站无法转换图片的问题（进而解决无法使用 assets + md 方案或 Textbundle 方案的问题）

• 使用简悦提供的【离线下载辅助增强插件】与【图床插件】解决在导出时图片无法显示的问题

[Kenshin]

导出根目录

设置导出根目录：

Mac 用户的路径 /xxx/Obsidian/SimpRead

Windows 用户路径 C:\\Users\\***\\Documents\\***\\Desktop\\Documents

注意：Windows 用户需要使用 \\ 方案

最佳方案

但更建议在 在同步助手端设置增强导出的路径 详细说明

增强导出的路径设置如下：

{"extension":"assets", "path":"/Users/***/Documents/Obsidian/SimpRead"}

Windows 用户需要使用 \\ 方案

{"extension":"assets", "path":"C:\\Users\\***\\Documents\\***\\Desktop\\Documents"}

注意

1. 同步助手端设置增强导出的路径 的优先级大于插件端，也就是说同时设定路径的话，以 同步助手端设置增强导出的路径 为主。

2. 此路径为绝对地址路径。

[Kenshin]

使用

手动方式

进入阅读模式，右下角触发器 → 动作 → 插件触发器 → 导出 md + assets 格式

自动方式

当加入稍后读后自动导出，需要安装 自动化辅助插件 后打开此插件，找到下图对应位置，并输入 a t

视频

2022-06-11_11-04-19.mp4

[Kenshin]

以 idx-title 的形式导出

当用户配置了 知识库 方案时，建议开启此功能，这样当加入稍后读后导出时，会以 idx-title 为标题。

导出后的标题

[Kenshin]

图片的导出类型

支持 HTTP 与 Base64 ，前者为默认值。

HTTP 方案

将当前阅读模式的图片直接发送到同步助手中，在同步助手中保存到本地。

Base64 方案

将当前阅读模式的图片先转换为 base64 格式，然后直接通过同步助手保存到本地。

一般用于：某些网页有一些限制导致无法使用 HTTP 保存图片，当使用后会出现下图所示的提示。

2022-11-19_12-45-17.mp4

注意

不建议使用此方式，因为「前端转换图片」会比较慢，只有在无法使用 HTTP 方案时再使用。

关联

• 通过简悦导出B站笔记到Obsidian时报错 #4510

• towardsdatascience 无法使用 assets 方案导入 #4620

[Kenshin]

图片导出位置

图片的导出位置在结构上与 Typora 保持一致，包含四种类型：

1️⃣ /${filename}/assets

2️⃣ ./${filename}.assets → 保存到 标题.assets 文件夹下

3️⃣ ./assets → 无论是多少个文章，将图片统一全部都保持到 assets 文件夹下面

4️⃣ custom → 将图片保存本地的任意目录

需要在下图所示的位置设置路径，位置在：导出 md + assets 格式选项

下面是一个例子，按上图所示，将图片保存到 Obsidian@simpread/media 下面

注意：此地址为绝对路径。

5️⃣ relative path

这是 1.2.0 增加的功能，相对 4️⃣ 的绝对路径，此方案支持 相对路径，使用语法如下：

./${filename}/attachments
./assets/${filename}.assets

. 是根目录 ${filename} 是当前阅读模式的标题（或稍后读），假设当前的标题叫作 简悦支持相对路径 则上面的内容翻译为

./简悦支持相对路径/attachments
./assets/简悦支持相对路径.assets

同时，也支持下面的方式

./attachments

即：将图片放到 根目录的 attachments 文件夹下面。

同时也支持更复杂的方案，使用语法 ::

./${filename}::./${filename}/assets

即：

./简悦支持相对路径/简悦支持相对路径.md
./简悦支持相对路径/简悦支持相对路径/assets/

此结构等同于 ./${filename}/assets 或 方案一 /${filename}/assets

以下是复杂方案的几种用法

./${filename}::./assets/${filename}.assets
./${filename}::../img/${filename}
./::./assets/${filename}.assets
./::./${filename}/attachments
./::./assets/${filename}
./Simpread/::./assets/${filename}
./${filename}::./${filename}/assets

[Kenshin]

@GentleLee

是的。

[Philosjay]

在我目前的使用场景下，此插件支持的4种图片存放位置方案似乎都没法满足我的需求，具体来说是这样：

1. 我的obsidian库使用了默认配置，每个笔记中的附件（包括图片）存储在与笔记文件同目录的attachments文件夹中，如下：
   • 笔记1
     • 笔记1.md
     • attachments
       • 图片1.jpg
       • 图片2.jpg
2. 我使用此插件将网页导出为 md+assets，导出位置的1、2、3方案都是将图片放到assets文件夹中，而我的obsidian的很多附件管理功能在识别笔记的附件时，都是在与笔记文件同目录的attachments文件夹中寻找附件，而不在assets`文件夹中，所以这3个导出方案与我的obsidian配置不兼容。
3. 如果使用方案4导出，可以用绝对路径将图片导出到同一个attachments文件夹中，导出多个网页后，不同网页的图片都混在同一个attachments文件夹中，而我需要像方案1那样将每个文档的图片存放在同目录的文件夹中，所以方案4也无法满足我的需求。

综上，我觉得如果插件能够支持自定义附件文件夹名称，就能以最小的代价满足我的需求，即我可以在方案1的基础上将assets目录名改为attachments就能满足需求。

不知我的使用方式和理解是否有误，求解答。

[DustyNight]

@Kenshin

我也有与相同的使用场景，一开始还以为能够通过custom实现，但实际试了才知道不行，希望能够支持自定义文件夹的功能

[Kenshin]

@Philosjay

抱歉，之前漏掉了这个信息。

前三种方案其实个你的方案很接近，只不过 assets 无法自定义。如果定义为 attachments 就满足你的需求了。

@DustyNight

简悦的第四种方案支持自定义文件夹，但不支持相对自定义文件夹，我会考虑的。

[Kenshin]

嗨，各位

md + assets 插件更新到了 1.2.0 增加了自定义图片保存路径的功能，细节请看 #4041 (comment) 里面提到的 5️⃣ relative path

注意：此功能需要配套同步助手 1.3.0 下载地址 & 更新日志

---

@Philosjay @DustyNight

解决方案是设置目录为 ./${filename}/attachments

@foreverlong

解决方案是设置目录为 ./assets/${filename}.assets

[Kenshin]

绝对路径与相对路径

注意

1.2.0 增加了更强大灵活的 定制路径规则 5️⃣ relative path

详细说明

此功能仅当选择 方案 ➍ 时 可用

使用绝对路径（启用此功能）

在 Typora 中预览效果

使用相对路径（禁用此功能）

在 Obsidian 中预览效果

[JimmyChou1729]

哈学习了学习了！

[apparition957]

https://github.com/renmu123/obsidian-image-auto-upload-plugin
![](<xxx>)如果引入该语法，该插件无法识别内容，导致无法上传图床

[Kenshin]

@apparition957

请在这个插件下提示，而不是这里。这个语法细节参见 #4041 (reply in thread)

[apparition957]

抱歉，我查了下markdown规范，![]()这种才是正确的，不需要额外引入<>这个符号
ref: https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images

[Kenshin]

@apparition957

![](<xxx>) 其中的 <xxx> 是为了防止 URL 断掉（有空格）的情况而设置的，大部分 Markdown 编辑器应该都支持它 e.g. Obsidian Typora Logseq 等。

PS：你查的仅仅只是 Github Markdown 规范。