151

KleverNotes, KDE's Markdown note-taking and management application using Kirigami, is ready for its first release!

KleverNotes lets you create and preview Markdown notes while giving you the freedom to customize the preview from settings or using a CSS theme.

You can organize your notes however you want with a combination of categories and groups, which will be directly reflected on your system in the hierarchy of your KleverNotes storage folders.

Simply choose your storage location and you're ready to write!

You can print your notes, add small sketches and even create specific tasks for each of them, all from the application!

Notes are saved as Markdown files in your KleverNotes storage for easy access. They support the entire CommonMark specification with extensive syntax. KleverNotes also introduces a small collection of opt-in “plugins” to extend basic markdown functionality, such as: code highlighting, note linking, quick emoji, PUML.

Special thanks

I would like to thank Carl Schwan who helped me through the incubator process, has set up the repository and the various KDE related things, fixed my code, and answered my many questions. The project would not be where it is without him.

History

I started KleverNotes as a small personnal project to learn QML and C++ and motivate myself to take notes in class. After posting a few screenshots of my progress on Reddit, people seemed pretty interested, which inspired me to continue and redouble my efforts. Once it was added to KDE, my motivation grew even more, my final goal is now to be able to offer a simple alternative to QOwnNotes using Kirigami. (I actively use KleverNotes in each of my classes now btw 😬)

Final note

This release doesn't add anything special compared to my last update, just UI tweaks from Carl, which makes the app better looking. I just wanted to get things moving in order to officially push more updates in the future. A big one is in the works and should arrive soon once my exams are finished.


As always, I'll be more than happy to answer your questions, discuss potential features, or hear your point of view 😉

Link to the repo: https://invent.kde.org/office/klevernotes

Mirrorlist: https://download.kde.org/stable/klevernotes/1.0.0/klevernotes-1.0.0.tar.xz.mirrorlist

top 50 comments
sorted by: hot top controversial new old
[-] some_guy@lemmy.sdf.org 18 points 3 months ago

Looks nice from the screenshot. Very clean.

[-] louis_sch@lemmy.kde.social 11 points 3 months ago

Thanks you !

I want it to look nice and easy to use while keeping some power under the hood ;-)

[-] graphito@beehaw.org 14 points 3 months ago

In the future, if you plan to add sync, consider reimplementing Joplin sync algorithm

That would give you tens of thousands of passionate users, dedicated FOSS server as well as webdav/s3/dropbox/onedrive client sync ability, webclipper and a lot of support to navigate future issues/roadmap

If you ever decide to do that, there's even a plan to repackage the algorithm as a standalone library

[-] louis_sch@lemmy.kde.social 9 points 3 months ago

My first plan is to add NextCloud Note sync

But if the two are compatible let's go for it ! Thanks for sharing this

[-] ChaoticNeutralCzech@lemmy.one 1 points 3 months ago

Yeah, I'm using Joplin over Nextcloud and it would absolutely be compatible, the Markdown syntax is the same after all.

[-] louis_sch@lemmy.kde.social 4 points 3 months ago

I'm not to much worried about the syntax, KleverNotes follows Common Mark, so as long as the other app follows it too (which it should) this part is okay

I'm more worried about directory structure and things like that, but I'll have to read more about both API before I can really say anything concrete on this subject

By the way, if you have something in Joplin that you really can't live without, let me know, I'm always looking for pottential features :)

[-] Rustmilian@lemmy.world 6 points 3 months ago

Is this why Kate dropped Markdown previews?

[-] vintageballs@feddit.de 6 points 3 months ago

Can I sync it with Nextcloud notes?

[-] louis_sch@lemmy.kde.social 13 points 3 months ago

Sadly not right now. I'm not against doing it, I just need to figure out the API

[-] magikmw@lemm.ee 2 points 3 months ago

Probably can open your notes directory in the nextcloud sync dir and it'd work.

[-] louis_sch@lemmy.kde.social 6 points 3 months ago

I don't have a Next Cloud instance but I don't see why this would not work :-)

Just need to walk the folder hierachy to your note

[-] magikmw@lemm.ee 4 points 3 months ago

It's how I sync my obsidian vault right now. Works well enough.

[-] edinbruh@feddit.it 6 points 3 months ago

Does it support KaTeX math, git integration, and spell checking? I'm using vscode for note taking but it's slow and power hungry

[-] louis_sch@lemmy.kde.social 7 points 3 months ago

Math integration is something I want, hesitant between Katex and ASCIIMATH, but there's no such thing currently

Technicaly no git integration, as in, there's no way to "git add/commit/Push" directly from the app, but you can style do it. Your notes are saved inside a folder, you can see the path directly from the settings, so you can technicaly use git on it. I personnaly use syncthing

No spell checking, never thought about it, could be a cool feature, thanks for the idea

[-] edinbruh@feddit.it 3 points 3 months ago

Well, I'm biased because KaTeX is load bearing to my use case. But I would argue that it:

  • Is more powerful
  • Is an introduction to LaTeX (which is an industry standard)
  • It's ubiquitous

You could consider using mathjax instead of KaTeX which should render both latex math and asciimath, (and should be better in general). If you had unlimited resources (which I guess you don't) it would be cool if you made the math language into a setting.

For git, other than the add and commit buttons, it would be useful to have a "git gutter" which shows changes from the last commit. Which is the only git integration feature that you can't get away with external tools.

For spell checking, even just pulling in some dictionary, like the ones in vscode's cspell extension and having a basic dictionary check is much better than nothing.

[-] louis_sch@lemmy.kde.social 3 points 3 months ago

You make a good case for it! But one thing that I also have to consider is the ease of implementing this into my C++ parser...

Right now I don't see how that would fit into the app to be honest, I'm not fully against the idea, but it would have to be nicelly integrated and I don't see how it would be (mostly in terms of UI/UX)

There's also KDE sonnet, I will have to look further into this, but that will most certainly be a future addition to the project!

[-] louis_sch@lemmy.kde.social 1 points 3 months ago

Will have to check it out, thanks

[-] anime_ted@lemmy.world 6 points 3 months ago

Maybe an edge case, but playing around with this I notice that if I create an ordered list at the same level directly after an unordered list, the preview displays it as an unordered list. This doesn't seem to happen if there is a separator between the two or if the ordered list is indented. Is this expected behavior or is it worthy of an issue?

[-] louis_sch@lemmy.kde.social 6 points 3 months ago

Just to be sure

Create an issue with the list sample so I can try it out by myself, it will be easier to debug ;-)

[-] anime_ted@lemmy.world 3 points 3 months ago

Done. Thanks!

I'm not against one more md note taking app and I like KDE, but do we really need one more?

Are there major differences planned compared to Joplin?

[-] klangcola@reddthat.com 14 points 3 months ago* (last edited 3 months ago)

directly reflected on your system in the hierarchy of your KleverNotes storage folders.

This is a big deal. Joplin is great, but its database structure is horrible for interoperability.

Hopefully Klevernotes will also be more snappy and "native feeling". Joplin being Electron can be a bit sluggish sometimes ( which is mildly infuriating given that the database structure was chosen over plain files due to "performance").

That said, it be nice if Klevernotes was a WYSIWIG editor. There really are a lot of dual-view markdown editors with a preview. For generel notes / productivity I find the dual view distracting, but need the preview for images etc

[-] louis_sch@lemmy.kde.social 6 points 3 months ago

"WYSIWYG like" editor is the next step

Not full richtext mode, but something similar to Marktext

[-] klangcola@reddthat.com 4 points 3 months ago

*Happy noises* :)

And I see there's a plugin for cross-linking between documents! More happy noises :)

And a nightly flatpak build :) Thanks for making it so easy to try out!

[-] louis_sch@lemmy.kde.social 3 points 3 months ago

It's normal! I want people to try it out and give me some feedback ;)

[-] KaKi87@jlai.lu 1 points 3 months ago

I was going to ask about exactly that, I'm very much looking forward to it, thanks !

[-] penquin@lemm.ee 4 points 3 months ago

I thought we already had a note taking app for plasma?

[-] louis_sch@lemmy.kde.social 7 points 3 months ago

Not from KDE

I tried it before creating Klevernotes, and it was just to much for me. I would like to make an alternative that look and feel simpler, while keeping the power.

But if QOwnNote is good for you, that's cool

load more comments (1 replies)
[-] louis_sch@lemmy.kde.social 7 points 3 months ago

You might not need one more, but I'm having fun making it and the work is here, so why not sharing it

Next step is "WYSIWYG like editor" And the addition of different Plugins

[-] AusatKeyboardPremi@lemmy.world 3 points 3 months ago

Joplin’s storage model made me stop using it.

Managing plain text notes should not be this convoluted.

I'm not a fan of the bloated plain text md files either. But I had not found a FOSS alternative that offers all the other features, like Android apps, pencip drawing support on tablets, the E2E encrypted sync between devices via a central server, ...

[-] DmMacniel@feddit.de 2 points 3 months ago

Does it support inline editing?

[-] louis_sch@lemmy.kde.social 3 points 3 months ago
[-] DmMacniel@feddit.de 5 points 3 months ago

Sure. I would like to know if this app allows to edit inside the rendered view. E.g. you click on a table cell and you get a caret to manipulate tect inside that cell. Something akin to a richtext editor.

[-] louis_sch@lemmy.kde.social 6 points 3 months ago

No, there's currently nothing similar to richtext editing.

You edit your text inside the editor and it is renderer in the preview. You can toggle on/off one or the other.

I tried to make things easier with the editor toolbar. You can easily create table from it through a dialog similar to the one from richtext editor such as LibreOffice writter

[-] Linus_Torvalds@lemmy.world 6 points 3 months ago

To add on to that: Obsidian is the only program that currently has this (to my knowledge) and it is a huge gamechanger. It just feels so much more usable than anything with a source and preview view. [I'm not demanding or anything, this is the stuff you do in your freetime, but you might want to go down that road.]

[-] louis_sch@lemmy.kde.social 9 points 3 months ago

A "WYSIWYG like" editor is currently in progress (next big update)

I don't want to go full richtext mode a la LibreOffice writter, it will be something similar as Marktext instead

You will still see the Markdown tag (e.g: the "#" in your heading) but with the possibility to style them in a way that make them pretty much dissapear when your note editing that part, and some nice color and font size for the important part, that would pretty much mimic the preview style ;-)

[-] hinterlufer@lemmy.world 4 points 3 months ago

Have you looked at how Obsidian handles it? I think their solution is pretty much perfect. You have the markdown, you write wysiwym, but you only ever see the source when your cursor is in that specific line/part. Also for equations.

[-] louis_sch@lemmy.kde.social 2 points 3 months ago

Yes that's pretty much the plan ;-)

And math support is wanted, I just need to check what would be best to do it

[-] Linus_Torvalds@lemmy.world 2 points 3 months ago

Sounds cool, where do I best keep up with the project? Is there some RSS feed?

[-] louis_sch@lemmy.kde.social 2 points 3 months ago* (last edited 3 months ago)

RSS feed looks good but to be honest I'm completly clueless about it, never used one

I'm posting detailled update on KDE Discuss (see the "last update" link in this post) when I've made enough progress in my opinion I think you can search them using the "klevernotes" tag

And I make Lemmy and Reddit post linking to those each time

Edit: and if you want to ask question, my dm on those platform are always open, or there's a Matrix channel (not super active, but I check it every day), the link is in the Readme of the project

[-] Linus_Torvalds@lemmy.world 1 points 3 months ago

Thanks, will check it out :)

load more comments (5 replies)
[-] limitedduck@awful.systems 1 points 3 months ago

Nextcloud also has this

[-] guillem@aussie.zone 1 points 3 months ago* (last edited 3 months ago)

If I understood it well, zettlr ~~and trilium~~ ha~~ve~~s this too: you start a line with pound signs and it changes its appearance to that of a header.

[-] nieminen@lemmy.world 1 points 3 months ago

Anyone familiar with obsidian and have also used this? Any comparisons you can make?

[-] louis_sch@lemmy.kde.social 2 points 3 months ago

Based on you use of Obsidian this might change

If you don't use some crazy Obsidian plugin the biggest change is the folder structure, which wil change to be less strict in the future

load more comments
view more: next ›
this post was submitted on 05 Jun 2024
151 points (98.7% liked)

KDE

5026 readers
21 users here now

KDE is an international technology team creating user-friendly free and open source software for desktop and portable computing. KDE’s software runs on GNU/Linux, BSD and other operating systems, including Windows.

Plasma 6 Bugs

If you encounter a bug, proceed to https://bugs.kde.org, check whether it has been reported.

If it hasn't, report it yourself.

PLEASE THINK CAREFULLY BEFORE POSTING HERE.

Developers do not look for reports on social media, so they will not see it and all it does is clutter up the feed.

founded 1 year ago
MODERATORS