TextBundle

by Tomte • 2 years ago

59 34 2 years ago

simonw3• 2 years ago

Something that isn’t clear to me from this spec http://textbundle.org/spec/ is the exact format of Markdown that should be used here.

I was under the impression that the Gruber original at https://daringfireball.net/projects/markdown/ wasn’t well enough specified (unless you want to treat a 20 year old Perl script as a specification) to be interoperable - hence efforts like https://commonmark.org/

ibash3• 2 years ago

It’s any text based format, you specify the type in info.json

kemayo2• 2 years ago

There's a "type" field in the spec, defined as: "The UTI of the text.* file. E.g. set to net.daringfireball.markdown for Markdown. This field should default to net.daringfireball.markdown to be backwards-compatible with version 1."

So it's whatever you care to specify. Doesn't have to be Markdown at all. It looks like it'd be completely valid to use this as a way to bundle up a webpage with all associated images and scripts, for instance.

simonw3• 2 years ago

But what does "net.daringfireball.markdown" mean? Does it mean "parse it using the 1.0.1 Perl script from 2004 on https://daringfireball.net/projects/markdown/ "?

pfix3• 2 years ago

Coming from Linux where your Filesystem is your database and I use obsidian because I can pop it over a file tree and have my vault integrated into the rest of my system, something like textbundle seems like alien and missing the point.

I like the general concept of sandboxing applications, but if it leads to this, it's more hindering than helping.

ibash3• 2 years ago

How do you handle attachments?

In particular, if you attach a file to a note in obsidian then no other program can link to the right attachment, right?

paxys• 2 years ago

There are no "attachments", just files and links.

Your directory has note.md and image.jpg. The note has a link to the image. The client can then render the markdown and image as it wants.

Any other application can also find and link to the attachment because...it's a file.

xenodium• 2 years ago

Relying on markdown links to local images works well on my machine, but breaks as soon as I'd like to share that markdown file with someone else.

Sure, I can zip everything and send them over, but it's not as friendly for recepient as receiving a document handled by popular viewers, specially if they have to modify it and send it back.

With wide adoption of something like TextBundle, we get to have our cake (keep using plain text) and eat it too (send, view, and edit richer files).

cspeterson• 2 years ago

I have in the past run markdown through an exporter that base64-encoded the images into the document before sharing with someone

solves this one issue at least

pfix3• 2 years ago

I've never had the usecase of sending markdown with images attached.

I use markdown for personal notes and in the rare case I shared them in the past, either there were no (relevant) links or I shared with e.g. confluence and I could just add the image.

My other usecase for markdown is Readmes and those are shared in git including the files.

I understood this spec mostly for sharing with local apps. Is that a missed usecase by me? Markdown documents instead of word/pdf/powerpoint/whatnot?

bityard• 2 years ago

Reading the site and spec, it sounds like TextBundle is specifically for exporting and importing your Markdown (or other documents) to and from various apps or other users. In particular, it's needed for software in the Apple ecosystem because there are (apparently) strict rules on how applications can communicate with each other.

Personally, I was hoping TextBundle would be something like a standard format for inserting binary content into Markdown files. (Something better than just base64, anywho.) I could use such a thing for my home-grown wiki.

qskousen• 2 years ago

If you don't mind, I'm curious what your use case is for inserting binary content into a Markdown file?

jen729w• 2 years ago

Notably created by Shiny Frog, authors of the very popular Bear editor for Apple platforms.

zokier• 2 years ago

seems like poor mans odf

eternityforest2• 2 years ago

So is it just a folder layout that can optionally be zipped? What's the actual on disk format? Is it something SyncThing would be happy about?

marcellus23• 2 years ago

You can download a sample file. It's a standard macOS package (https://developer.apple.com/library/archive/documentation/Co...).

eternityforest2• 2 years ago

I don't have a MacBook or know anything about how their packaging works, but it seems like it's pretty well documented, maybe even better than a lot of package formats

amai2• 2 years ago

Spread the word. Unfortunately Obsidian and Devonthink (and many other apps) don’t yet support this format. But it solves a really important problem: How to exchange markdown documents that include attachments like images, video etc. in a standard way?

rauhl• 2 years ago

But it solves a really important problem: How to exchange markdown documents that include attachments like images, video etc. in a standard way?

Oddly enough, I was recently thinking of using RFC 822 messages with CommonMark bodies and MIME attachments as a way to store blog entries on disk, so I was considering this exact problem earlier this week (small world!). RFC 2046 specifies multipart messages, RFC 2392 specifies URI schemes for linking from the body of the message to other parts; and RFC 7763 specifies the text/markdown MIME type. There’s already a ton of tooling out there which deals with MIME, so one needn’t reinvent the wheel.

amai2• 2 years ago

Interesting idea. Actually I wonder why we don’t have Markdown in emails, yet. It seems to be an obvious idea.

vunderba• 2 years ago

TextBundle brings convenience back - by bundling the Markdown text and all referenced images into a single file

... So basically a markdown version of the ePub format?

Slightly related, but Typora offers an option that handles inlined media for a markdown note in a pretty sleek way. It creates a folder in the same location as the markdown note with following syntax (markdown-file-name.assets). Any time you drag/copy/etc a image/video/etc into the markdown editor it copies the file into the asset folder.

w10-1• 2 years ago

Unchanged since 2014?

Surely with Pandoc and macOS/iOS progressing relentlessly, there would be some technical advances even in a basic file bundle.

maliker• 2 years ago

I spent a lot of time investigating all the editors on this list because I want a rich text editor that works with single files and is as clean powerful as VS Code (or sublime, emacs, whatever you prefer). Didn't end up using any of them since nobody else uses this format. Went back to .docx. Sad.

dr_kiszonka• 2 years ago

I am hungry for something new, but Word is probably the most popular text editor in the world. If I am writing just for myself, I will most likely use markdown or maybe Typst. If I am to collaborate on it with others, it will probably be .docx or Google Docs.

TextBundle

Related Stories