Just created a subdomain with my
notes, or wiki, or digital garden. Whatever you want to call it. It’s mostly for personal reference if I need it, but you can take a look too 😉
Just created a subdomain with my
So… replying to myself. Probably what I’m going to do is quite similar to what I had before: statically generate the notes from source markdown (or something else). I first need to decide the best language. Markdown is simples, yes, but sometimes I feel I need to add HTML to make it look exactly how I want it to. For example, I can’t just do this in markdown without using HTML. Some other markup languages allow for much more customization, such as Asciidoc.
Let me review the features I wrote yesterday to know if I can accomplish what I want this way. First, the must-haves:
Self hosted and open source Notes stored in plain text files Backlinking feature Supports LaTeX math Supports Mermaid diagrams
Yes, yes, yes, yes and yes even if I have to create some script to adapt it to whatever static website generator I’m using. Unfortunately Hugo does not easily allow me to process backlinks on its own. I may try a different, more flexible, static generator for this. It’s an experiment and that way I’ll learn more. Maybe Gatsby or even Eleventy.
Clean layout and possible to easily edit on mobile
Yes and kinda. Need to find a good app. There’s some such as iA Writer that I know work very well. But I need to find a way to make it easily work with a Git repository.
Web editor (maybe WYSIWYG)
GitHub editor works. Not WYSIWYG though.
Simple and humanly readable markup language (markdown or other)
Can be implemented, although a bit harder.
Now let’s finally review the good to have features.
Can be implemented too.
Mind map visualization
Possible, harder, but possible.
Taking notes is a process… that’s true. Yesterday I found a post on HackerNews talking about how tired people are of new notes apps. I agree: there’s so many different note-taking apps that it becomes unbearable to find whatever fits you. I have a giang repository of markdown files with images and a lot of notes, all interconnected. And I still couldn’t find a good app for me. That’s why I’m considering building one simple system for myself, initially private to avoid possible noise, and then open source. My requirements for a system are these:
- Self hosted and open source
- Notes stored in plain text files
- Backlinking feature
- Supports LaTeX math
- Supports Mermaid diagrams
- Clean layout and possible to easily edit on mobile
- Web editor (maybe WYSIWYG)
- Simple and humanly readble markup language (markdown or other)
Good to have:
- Full-text search
- Mind map visualization
- Public/private stuff
Do you know any application that accomplishes all of this cumulatively? I liked this visually and there’s also this being built but I have no clue about when’s it going to be available or how the storage will work.
If I would create this, it would be just yet another note-taking app, but with a small difference in mind: this would be directed to be self-hosted for just one person. No services, for myself, as I wanted it to work.
For quite a few time, I used Bear as my go-to Notes application for two reasons: it was single to use and the syntax was quite similar to markdown. However, it is not markdown and it does not support some things that’d like to see on such software: diagrams, mathematics, wiki-like links, etc.
After searching for a bit I found out an app called Notable. In addition to having all the features I wanted from Bear, it is also storage independent, meaning everything is stored as markdown plain-files that I can version control with Git or some similar software.
This is just a FYI: if you’re interested, I recently added a
knowledge base section to the website where I automatically deploy de notes I write with Notable. I actually have some ideas of things to add to these notes when I have time. It’s actually quite simple: just set up a GitHub hook, pull the notes repo, convert them to Hugo’s format and et voilá!