[GH-ISSUE #531] [feat] 允许图片存储到Markdown文件的相对目录并同步至仓库，替代 GitHub 图床

kerem commented

2026-03-02 03:39:33 +03:00

Owner

Originally created by @FrozenRod on GitHub (Aug 7, 2025).
Original GitHub issue: https://github.com/codexu/note-gen/issues/531

描述你的建议

首先，非常感谢作者开发出如此优秀的笔记软件！从我第一次使用这款工具开始，它便成了我日常笔记管理的重要部分。它通过 GitHub/Gitee 同步笔记的设计非常符合我的需求，和我之前手动用 git 命令管理笔记的习惯完美契合。关于图片同步的方式，我想提一个改进建议。

当前的问题：

目前软件只能同步 Markdown 文件，而图片需要单独上传到 GitHub 图床。这带来了以下不便：

依赖图床稳定性：GitHub 图床对国内网络不友好，我在家、公司、外地出差等多个环境经常出现网络问题，jsDelivr加速作用并不大。
管理繁琐：需要额外维护图片和图床，无法和笔记文件一起管理。
隐私问题：我不希望我的图片让别人通过一个链接就能访问到。
离线无法查看：图片依赖网络加载，没有缓存时离线无法正常显示。

建议的改进方案：

建议增加选项：允许图片存储到Markdown文件的相对目录并同步至代码仓库
具体实现模型：

.
├── Note.md                 # Markdown主文件
└── assets/                 # 自动创建同级资源目录
    ├── 1.png               # 直接拖入的图片
    └── other.bin           # 支持所有二进制文件（如果可以的话）

在Markdown中自动生成：![](assets/1.png) 的相对路径引用

这一改进的优点：

操作更简单：图片和笔记一起管理，无需额外维护图床。
更稳定可靠：图片随笔记版本控制，不会因图床问题失效。
离线可用：图片和笔记一起存储，断网也能正常查看。
兼容性更好：GitHub/Gitee 原生支持渲染相对路径的图片。

Originally created by @FrozenRod on GitHub (Aug 7, 2025). Original GitHub issue: https://github.com/codexu/note-gen/issues/531 ### 描述你的建议首先，非常感谢作者开发出如此优秀的笔记软件！从我第一次使用这款工具开始，它便成了我日常笔记管理的重要部分。它通过 GitHub/Gitee 同步笔记的设计非常符合我的需求，和我之前手动用 `git` 命令管理笔记的习惯完美契合。关于图片同步的方式，我想提一个改进建议。 ### 当前的问题：目前软件只能同步 Markdown 文件，而图片需要单独上传到 GitHub 图床。这带来了以下不便： 1. **依赖图床稳定性**：GitHub 图床对国内网络不友好，我在家、公司、外地出差等多个环境经常出现网络问题，jsDelivr加速作用并不大。 2. **管理繁琐**：需要额外维护图片和图床，无法和笔记文件一起管理。 3. **隐私问题**：我不希望我的图片让别人通过一个链接就能访问到。 4. **离线无法查看**：图片依赖网络加载，没有缓存时离线无法正常显示。 ### 建议的改进方案：建议增加选项：**允许图片存储到Markdown文件的相对目录并同步至代码仓库** 具体实现模型： ``` . ├── Note.md # Markdown主文件 └── assets/ # 自动创建同级资源目录 ├── 1.png # 直接拖入的图片 └── other.bin # 支持所有二进制文件（如果可以的话） ``` 在Markdown中自动生成：`![](assets/1.png)` 的相对路径引用 ### 这一改进的优点： 1. **操作更简单**：图片和笔记一起管理，无需额外维护图床。 2. **更稳定可靠**：图片随笔记版本控制，不会因图床问题失效。 3. **离线可用**：图片和笔记一起存储，断网也能正常查看。 4. **兼容性更好**：GitHub/Gitee 原生支持渲染相对路径的图片。

kerem added the

feature

label

2026-03-02 03:39:33 +03:00

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@codexu commented on GitHub (Aug 11, 2025):

这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。
我来考虑一下如何实现它。

@codexu commented on GitHub (Aug 11, 2025): 这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@codexu commented on GitHub (Aug 11, 2025):

另外需要注意下 Github 仓库限制：
https://docs.github.com/zh/repositories/working-with-files/managing-large-files/about-git-large-file-storage

@codexu commented on GitHub (Aug 11, 2025): 另外需要注意下 Github 仓库限制： https://docs.github.com/zh/repositories/working-with-files/managing-large-files/about-git-large-file-storage

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@WuxuFanhua commented on GitHub (Aug 13, 2025):

这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。

使用本地图床时,文件自动保存到assets目录后,可以同步asset文件夹.取消文件限制.以及在另外设备同步时,点击前,先判断本地是否存在此文件,不存在的话,下载到本地,然后判断文件类型,在根据文件类型去打开对应编辑器,或者打开图片.

@WuxuFanhua commented on GitHub (Aug 13, 2025): > 这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。使用本地图床时,文件自动保存到assets目录后,可以同步asset文件夹.取消文件限制.以及在另外设备同步时,点击前,先判断本地是否存在此文件,不存在的话,下载到本地,然后判断文件类型,在根据文件类型去打开对应编辑器,或者打开图片.

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@codexu commented on GitHub (Aug 14, 2025):

另外，应该增加一个开关，并不是所有人都这样使用。

@codexu commented on GitHub (Aug 14, 2025): 另外，应该增加一个开关，并不是所有人都这样使用。

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@meihao123 commented on GitHub (Oct 6, 2025):

这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。

使用本地图床时，文件自动保存到assets目录后，可以同步asset文件夹。取消文件限制。以及在其他设备同步时，点击前，先判断本地是否存在此文件，不存在的话，下载到本地，然后判断文件类型，在根据文件类型去打开对应编辑器，或者打开图片。

如何取消文件限制啊？还有为啥同步了assets文件夹后，GitHub仓库还是看不见呢？是科学上网的问题吗，可是我已经开了v2rayn啊

@meihao123 commented on GitHub (Oct 6, 2025): > > 这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。 > > 使用本地图床时，文件自动保存到assets目录后，可以同步asset文件夹。取消文件限制。以及在其他设备同步时，点击前，先判断本地是否存在此文件，不存在的话，下载到本地，然后判断文件类型，在根据文件类型去打开对应编辑器，或者打开图片。如何取消文件限制啊？还有为啥同步了assets文件夹后，GitHub仓库还是看不见呢？是科学上网的问题吗，可是我已经开了v2rayn啊 <img width="2520" height="1608" alt="Image" src="https://github.com/user-attachments/assets/ef1b50a0-71d2-426a-a25f-edfff0698e83" />

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@WuxuFanhua commented on GitHub (Oct 6, 2025):

这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。

使用本地图床时，文件自动保存到assets目录后，可以同步asset文件夹。取消文件限制。以及在其他设备同步时，点击前，先判断本地是否存在此文件，不存在的话，下载到本地，然后判断文件类型，在根据文件类型去打开对应编辑器，或者打开图片。

如何取消文件限制啊？还有为啥同步了assets文件夹后，GitHub仓库还是看不见呢？是科学上网的问题吗，可是我已经开了v2rayn啊

涉及文件较多…建议等作者新增此功能🌚 除了取消文件限制同步文件方法也有改动

@WuxuFanhua commented on GitHub (Oct 6, 2025): > > > 这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。 > > > > > > 使用本地图床时，文件自动保存到assets目录后，可以同步asset文件夹。取消文件限制。以及在其他设备同步时，点击前，先判断本地是否存在此文件，不存在的话，下载到本地，然后判断文件类型，在根据文件类型去打开对应编辑器，或者打开图片。 > > 如何取消文件限制啊？还有为啥同步了assets文件夹后，GitHub仓库还是看不见呢？是科学上网的问题吗，可是我已经开了v2rayn啊 > > <img alt="图像" width="2000" height="1608" src="https://private-user-images.githubusercontent.com/50229452/497667611-ef1b50a0-71d2-426a-a25f-edfff0698e83.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NTk3MzM5NDEsIm5iZiI6MTc1OTczMzY0MSwicGF0aCI6Ii81MDIyOTQ1Mi80OTc2Njc2MTEtZWYxYjUwYTAtNzFkMi00MjZhLWEyNWYtZWRmZmYwNjk4ZTgzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTEwMDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUxMDA2VDA2NTQwMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWZmYWJhNGUzYjM2NzEzMzFjNzAyODRjODdlY2E2NzQxMWQ0ZDA5MmQwYTU2Y2Q5OTczZjFhMTdlODIxNTg4NWImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.2qKkHZihr392ef8_Gaggh8ENKAF2r9AM7B82K6PGXK0"> 涉及文件较多…建议等作者新增此功能🌚 除了取消文件限制同步文件方法也有改动

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@meihao123 commented on GitHub (Oct 6, 2025):

这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。

使用本地图床时，文件自动保存到assets目录后，可以同步asset文件夹。取消文件限制。以及在其他设备同步时，点击前，先判断本地是否存在此文件，不的话，下载到本地，然后判断文件类型，在根据文件类型去打开对应编辑器，或者存在打开图片。

怎么取消文件限制啊？还有啥同步了assets文件夹后，GitHub仓库还是看不见呢？是科学上网的问题吗，不过我已经开了v2rayn啊

涉及文件限制预测...建议等作者新增此功能🌚除了取消文件同步文件方法还有其他

你说作者取消了文件同步功能，所以图片没法同步是吧？那图床呢也不行吗？

@meihao123 commented on GitHub (Oct 6, 2025): > > > > 这个功能一直存在一定的争议，这个功能可能很适合少量图片的用户使用。我来考虑一下如何实现它。 > > > > > > > > > 使用本地图床时，文件自动保存到assets目录后，可以同步asset文件夹。取消文件限制。以及在其他设备同步时，点击前，先判断本地是否存在此文件，不的话，下载到本地，然后判断文件类型，在根据文件类型去打开对应编辑器，或者存在打开图片。 > > > > > > 怎么取消文件限制啊？还有啥同步了assets文件夹后，GitHub仓库还是看不见呢？是科学上网的问题吗，不过我已经开了v2rayn啊 > > <img alt="图像" width="2000" height="1608" src="https://private-user-images.githubusercontent.com/50229452/497667611-ef1b50a0-71d2-426a-a25f-edfff0698e83.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NTk3MzM5NDEsIm5iZiI6MTc1OTczMzY0MSwicGF0aCI6Ii81MDIyOTQ1Mi80OTc2Njc2MTEtZWYxYjUwYTAtNzFkMi00MjZhLWEyNWYtZWRmZmYwNjk4ZTgzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTEwMDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUxMDA2VDA2NTQwMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWZmYWJhNGUzYjM2NzEzMzFjNzAyODRjODdlY2E2NzQxMWQ0ZDA5MmQwYTU2Y2Q5OTczZjFhMTdlODIxNTg4NWImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.2qKkHZihr392ef8_Gaggh8ENKAF2r9AM7B82K6PGXK0"> > > 涉及文件限制预测...建议等作者新增此功能🌚除了取消文件同步文件方法还有其他你说作者取消了文件同步功能，所以图片没法同步是吧？那图床呢也不行吗？

kerem commented

2026-03-02 03:39:34 +03:00

Author

Owner

@meihao123 commented on GitHub (Oct 6, 2025):

用gitee会不会跨端访问文件图片更快些，因为图床的情况assets文件里面的图片用华为手机半天加载不出来

@meihao123 commented on GitHub (Oct 6, 2025): 用gitee会不会跨端访问文件图片更快些，因为图床的情况assets文件里面的图片用华为手机半天加载不出来![Screenshot_20251006_181440_com.codexu.NoteGen.jpg](https://github.com/user-attachments/assets/9b498209-2a18-4e7c-86a8-9c5981786526)

kerem commented

2026-03-02 03:39:35 +03:00

Author

Owner

@JLiu109 commented on GitHub (Oct 13, 2025):

另外，应该增加一个开关，并不是所有人都这样使用。

希望可以开发这个功能，多个开关可供选择

@JLiu109 commented on GitHub (Oct 13, 2025): > 另外，应该增加一个开关，并不是所有人都这样使用。希望可以开发这个功能，多个开关可供选择

Rows
Columns

[GH-ISSUE #531] [feat] 允许图片存储到Markdown文件的相对目录并同步至仓库，替代 GitHub 图床 #384

描述你的建议

当前的问题：

建议的改进方案：

这一改进的优点：