The plan for Obsidian is to never grow beyond 10-12 people, never take VC funding, never collect personal data or analytics.

Continue building with the assumption that software is ephemeral, files matter more than apps. Use formats that are open and durable.

See our manifesto:
https://obsidian.md/about

About - Obsidian

Our guiding principles are set in stone: yours, durable, private, malleable, independent.

Obsidian

From a traditional business perspective the Obsidian approach has many downsides:

we can only focus on 1-2 things at a time, we can't build lots of stuff in parallel like a bigger company can

we have to cover our costs, we can't subsidize pricing — charging a fair price is a disadvantage in the market

we have no lock-in, our users can leave at any time easily

we have less freedom to build fancy features that rely on unencrypted private data (like cloud-based AI) or more sophisticated non-portable data formats

we have limited metrics to inform product decisions, we have to learn directly from what users say

users have the freedom to significantly modify the app via plugins, more things can go wrong or feel less cohesive

... I would not recommend this approach to every business, but these are the tradeoffs we choose knowingly.

A principle is only useful if you can legitimately take the opposite side.

Otherwise it's simply an aspiration that everyone else is also shooting for.

@kepano Well, at least I appreciate it. And I try to spread the word where I can. 😃

I got the insider access to financially support you folks. Have you thought about the case where people don't need the monthly services, but would like to toss some money your way to ensure you folks can keep working on it? I doubt your organisational status allows donations, right?

@asmodai We used to have a donation program but we removed it because very few people used it. The best thing you can do is spread the word 💜

@kepano I profoundly appreciate the "future-proof" focus—it's part of why I pay for Sync!

So I hope the #Obsidian team realizes the current mouse-dependent editing & reading views aren't future-proof. They're an inaccessible form of interface lock-in.

You have recently done a great job of making Obsidian Publish sites more #accessible. Please bring that same principle to all aspects of the editor itself.

Every element (collapsible headings, tasks in queries, list items, etc) that can be interacted with via mouse needs an built-in, equivalent keyboard interaction.

Because these are your core principles, keyboard #accessibility should be a core behavior, not outsourced to a community plug-in that will eventually stop being maintained.

Here are some key resources for keyboard accessibility:

- https://www.w3.org/WAI/perspective-videos/keyboard/
- https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG/Keyboard#interactive_elements_must_be_able_to_be_activated_using_a_keyboard
- https://webaim.org/techniques/keyboard/

Here's proof other editors make it work:

- TinyMCE: https://www.tiny.cloud/docs/tinymce/6/keyboard-shortcuts/
- VSCode: https://code.visualstudio.com/docs/editor/accessibility#_keyboard-navigation

Keyboard Compatibility

Short video about keyboard compatibility for web accessibility - what is it, who depends on it, and what needs to happen to make it work.

Web Accessibility Initiative (WAI)
@ryanrandall Keyboard accessibility is a top priority — we have a loud contingent of vim users who make sure of that! What's missing? The examples you gave are already keyboard accessible.

@kepano I'm thrilled to hear it's a top priority!

In Reading (not Editing) view, what are the keyboard shortcuts for navigating to a Tasks query and checking off a task, or navigating to and collapsing a heading? (I'm on Mac.)

I've trawled the Help site ( https://help.obsidian.md/Home ), searched the Forums, and asked in Discord, and haven't found a way to do it.

Home - Obsidian Help

Obsidian Help Welcome to the official Obsidian Help site, where you can find tips and guides on how to use Obsidian. For API documentation visit the Obsidian Developer Docs. You can browse this site …

Obsidian Help
@ryanrandall Ok, feel free to create issues on the forum for anything that's missing!
@kepano learning directly from users sounds like a dream to me

@kepano

> we have limited metrics to inform product decisions, we have to learn directly from what users say

I don't fundamentally object to the idea of anonymized telemetry helping to improve a product, but I suspect such data is often used mainly to figure out how to extract more money from me.

@toddz @kepano
Obsidian has *no* telemetry so you can rest quite assured with that.

@nhan @kepano

Thanks, I should have been more clear: I appreciate that Obsidian has no telemetry contributing to metrics, though I'm not completely against any and all telemetry in all cases.

@kepano

> we have limited metrics to inform product decisions, we have to learn directly from what users say

Obsidian seems like a case study on how collecting & acting on feedback from a passionate user base grows enthusiasm, loyalty, and evangelism.

@kepano the big companies always ruin the products because they focus more and more on one thing only, monetization - not usability and usefulness

@kepano

That all means not too much as long as the code is not free software.

@nik Why? The files are yours and in free and open formats. For a notetaking app the file over app philosophy is much more important than free code
https://stephanango.com/file-over-app

Don't get me wrong, I love open source deeply. I have built and contributed to many FOSS projects:
https://stephanango.com/projects

However, if you are trying to sustain a project for the long term it needs a way of paying people. I have never been able to pay my bills from FOSS, though that could be due to my own lack of creativity.

File over app

File over app is a philosophy: if you want to create digital artifacts that last, they must be files you can control, in formats that are easy to retrieve an...

Steph Ango

@kepano

No. No, I don't agree it doesn't matter what the app does with my nicely open-formatted notes. Whether their telemetry or whatever leaks my private notes is not a matter of file format.

I can't speak for you, but my own pure open source (and free software) work pays my bills and that of three employees who themselves work on FOSS projects that don't contribute to our income themselves.

@kepano I love that and you
@kepano @xoofx This is one of the reasons why last month, switching from Evernote, I picked Obsidian with sync subscription over all the alternatives.
So far, I'm also very happy about it as a product. :)

@BartWronski @kepano good to know! I tried it quite some time ago and I think I liked it, but as I was/am using VS Code for editing all my Markdown files, I was not sure I was getting enough added value from Obsidian to switch to it...

But I should probably give it another try!

@xoofx @kepano I probably wouldn't care for any markdown editor other than basics like VSCode. I was looking for something for notes, collecting links and scientific research for work, code snippets, journaling, task management - all in one system. Pus it had to be on both iOS and Windows.
And with plugins, it seems definitely capable of all that.

@BartWronski @kepano oh, yeah, actually, It was very similar for me... I think I looked at it because several years ago (and sometimes it comes back from time to time) I was reading lots of graphics, compiler papers (PDF) and articles on the web, and I'm trying to have notes on the sides, but I have always been looking to organize all my knowledge searching/collecting/notes in a unified way.

I thought Obsidian could help, but maybe I missed some features... but I should definitely try again.

@BartWronski same here!
I was bummed to hear about Evernote being sold, but I like having everything in markdown much better!
@kepano I use Obsidian for work and PKM and I really love everything that can be done with it. Thank you and please keep doing what you’re doing.
@kepano i love this. we need a culture shift. too many people in the world default to if it makes money it justifies mistreating people. stuff like this helps spread alternate mindsets on success.
@kepano ❤️
Just added "insider" to already existing sync subscription.
@kepano obsidian already does so much and I'm looking forward to the new features on the horizon. The fact that you have solid mobile apps is really impressive already.
@kepano smells like a plain Markdown Wiki.
I hope people will understand the power of those simple base mechanisms to build elaborate notes and documentations.
The world needs more usage of open and interoperable standards instead of being caught in the cage of trillion dollar companies.
@kepano ❤️ what you're doing! Obsidian is my favorite notes app of all time. Slow and steady is the way. We want you around for a very long time, not burning out too soon.

@kepano I appreciate that you use open formats.

I know Obsidian supports a few useful, non-standard additions to markdown, such as callouts and embeds. It would be helpful if there was explicit documentation for these syntaxes. That would aide in interoperability with other apps and formats.

If I remember correctly, Obsidian uses markdown-it internally, so if you linked to a plugin, that would be even more helpful.

@binyamin Here's the documentation on that topic
https://help.obsidian.md/Editing+and+formatting/Obsidian+Flavored+Markdown

I admit it could be a bit more detailed, will polish that up

Obsidian Flavored Markdown - Obsidian Help

Obsidian strives for maximum capability without breaking any existing formats. As a result, we use a combination of flavors of Markdown. Obsidian supports CommonMark, GitHub Flavored Markdown, and La…

Obsidian Help
@kepano
@yoavzack עושה לי חשק להשתמש, אבל אין לי צורך בעבודה או ביומיום...
אבל טוב לדעת!
@kepano that sounds good on paper...
@kepano thank you! This has inspired me to purchase a catalyst license.
@kepano If you all ever run into a situation that prevents you from continuing the development, will Obsidian's source be released under a (F)OSS license?
@kepano Great to hear! I’ve tried out a bunch of note-taking apps but I always went back to Obsidian, so I’d be sad if it went bad.
@kepano This makes me even prouder to be a paying customer. Thank you.
@kepano I’ve been using Obsidian for a couple of years now. It has become the second thing I always install in new devices, right after my password manager. I love it.
@padawan thanks for your support! 💜
@kepano Thank you for this. These are things I believe software should do, too. And, Obsidian is perfectly usable right now; I don't think it needs fast revolutionary change. You're doing a great job.

@kepano

🙏 Please add an image description to each of the two images in your post about the manifesto.

I would like to boost it, but I cannot do so:
If there is no alt-text linked to the image people who use a #ScreenReader will only hear one frustrating word:

"image"

#InclusionMatters and it's not just a »nice to have« but an expression of our fairness to other people.

@khzimmer2 oops, I thought I had. I wonder if my client bungled it.
@kepano that is nice to hear, really. I'm so tired of great software turning to crap when it starts to become popular and is growing like crazy, and then the priority slowly shifts from building a great product to making as much profit as possible.
@kepano This is awesome and makes me feel great about my subscription. Wish more companies did this.

@kepano Love more "startups" being more customer-first (not investor-first) and self sustainable.

I have worked with VC funded startups before, they're great, can move super fast. But from an user's perspective the uncertainty of the company's and the product's future. Because VC funded startups goal is to make as much money for the VC fund (-> investors), they need to aim really high and take a lot of risks, leading to a high fail rate. Not particularly to create a great product for the users that they can rely for long.

For this reason I wouldn't personally want to go with a VC funded startup for a core/must-have important services like email, drive, documents, etc.

@kepano @obsidian how do I save web clips on iOS to Obsidian?
@kepano after reading this thread, I decided to buy Catalyst. Thanks for making a cool product in a sustainable way!
@kepano Thank you, it's not an easy decision, as a user I'm appreciating it a lot.
@kepano thanks! Buying my catalyst license today :)
@kepano Have you ever though of a way to make this manifesto itself future-proof? (i.e. In case of a change of ceo...)
@kepano I use it and it's great.