vnotex / vnotex/vnote

建议:支持 TextBundle

Open
#1,423 4 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C++
Stars
13k
Forks
1.3k
Avg merge
14h 3m
Merged PRs (30d)
3

Description

一直以来,md 文档插入图片的通用性都是问题:

  • 用图床链接,不稳定

  • 用本地文件链接,容易丢

这也是我在用 md 做记录时候的烦恼。

VNOTE 使用了 json 和私有图片链接形式,但如果把笔记文件夹复制到比如安卓平台上,用其它 md 编辑器打开,里面的图片是没办法显示的。

不过,Marked 开发者和 Ulysses 团队就开发出了一种解决方法,就是 TextBundle,简要解释一下,它是这样的结构:

一个叫 文档.textbundle 的文件夹,内包含:

o    一个 assets 文件夹,用于存放图片等附件

o    一个 info.json 文件,用于存放相关的元数据

o    一个 text.md 文件,用于存放文档内容。文档通过相对路径引用 assets 文件夹内的图片和其它媒体文件。

可以实现一个文包内,既包含 md 文档,也包含图片,预览时无需询问权限,同时又方便直接编辑,非常便捷。

每一个文档都存储在一个 textbundle 中,这样,即便导出,复制到其它设备、平台上,都可以用各种 markdown 编辑器打开文档,正常浏览里面的图片。

Ulysses, Bear这样的流行的写作工具,甚至是Mindnode等思维导图工具,都支持 textbundle,Typora 也表示会在接下来某个版本中支持 TextBundle。

如果支持textbundle格式。那么我们在快速写作的时候,就可以更加安心。因为我们确认所有的创作内容都可以方便导出带格式、带图片资源版本,轻松在其他专用工具中进一步加工,并且所有笔记都可以与任何笔记软件兼容。

这里是 TextBundle 的 官网详细细节,你可以在官网看到已支持 TextBundle 的软件。

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read the TextBundle specification linked in the issue and compare its required assets, info.json, and text.md structure with VNote's note export and import behavior. Done means notes can be stored, copied, and opened with their Markdown content and attached images intact across supported platforms.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
content, desktop
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.