导出 md + assets 格式

[Kenshin]

描述

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

地址

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

视频

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

快捷键

a t

前提

此功能依赖于 同步助手 1.0.2 版，关于此版本的详细说明 请看这里。

Obsidian 用户

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

使用

支持手动导出或加入自动化时导出，详细说明 请看这里。

选项

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

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

功能

1. 是否添加 Metadata，关于 Metadata 占位符 请看这里。

2. 导出位置

3. 以 idx-title 的形式导出

   

4. 图片导出位置

   

5. 图片导出类型

   

关联

• 利用 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]

导出位置

通常情况下，建议设置路径，如果不设置路径的话，需要 在同步助手端设置增强导出的路径，详细说明 请看这里。

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

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

注意

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

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

[Kenshin]

使用

手动方式

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

自动方式（当加入稍后读后自动导出）

安装 自动化辅助插件 然后按照下图设置，即可。

视频

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 → 将图片保存本地的任意目录，详细说明 请看这里。

[Kenshin]

作者，请问！导出md+assets到obsition怎么实现：图片自动上传到picgo图床，文章内的图片全部自动转化为链接。

都上传到你自己的图床了，就不需要使用 assets + md 了吧... 😂

[GentleLee]

大佬，请问下导出图片的重命名规则是什么样的呢？

[Kenshin]

@GentleLee

日期的时间戳 e.g. 1728783454758.png

[GentleLee]

感谢，意思就是不会重名了？

[Kenshin]

@GentleLee

是的。

[Kenshin]

绝对路径与相对路径

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

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

在 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 规范。