Neorg – organize your life in Neovim
github.com
github.com
From watching the videos, the guy mentions that a problem early on was that it was constantly compared to org-mode, which was confusing to people not familiar with org-mode, so I guess they're trying to get away from that?
I watched a few videos and saw syntax and features almost identical to the most basic level of org-mode.
The one feature it seems to have over org is that it uses a C++ based parser, which might be faster than the mostly elisp parser from org-mode? But even that means it relies on features of C++14, which isn't included with macOS, so I'm left feeling like this is half anti-feature compared to org-mode's highly portable parser: If Emacs works, org-mode will work, and Emacs is mostly elisp itself, so if the elisp interpreter works, Emacs will work.
If I can run an executable I can run org-mode essentially, but this requires I'm allowed to install a whole new compiler on a machine before using it.
I think it was Prot that put forward a strong case for building an org-mode specification with multiple compatibility levels, so that tools for other platforms could say they implement a certain subset of its features and syntax using a simple shorthand like "Org-Mode Level 3 Compatible". I'd like to see that effort go further.
It's silly I know, but I vastly prefer writing in markdown and it's relatives than in Neorg (or org mode for that matter).
It was also weird that they chose to be incompatible with org mode, ditching all tooling around it in the process.
Neorg – Life Organization Tool Written in Lua for Neovim - https://news.ycombinator.com/item?id=29330805 - Nov 2021 (5 comments)
Neorg: Neovim 0.5’s answer to modern life organization - https://news.ycombinator.com/item?id=27802153 - July 2021 (72 comments)
But I do have the same question. Docs. Can we help?
I installed it prior to this hn post and it works, but is a bit hard to discover what you can do with it.
There's just too many org-adjacent packages already written in elisp. Plus, terminal independent image rendering just works in Emacs.
I hate this trend of having video explainers before having actually functional docs. I have no interest in watching someone fumble around a Youtube video when I could alternatively just Ctrl+F a docs page and find the information I need.
For anyone interested, there are alternatives that are more Markdown compatible. Vimwiki, as an example, is great.
I expect that's nice if you don't like emacs for some strange reason :D (and indeed object to setting up evil mode).
My curiosity is dampened by it not really explaining on the wiki very well and trying to force me to watch a video.
It has it's own language (not markdown) and key bindings
I find it harder to use than markdown with wiki link support
Org-mode is far more superior than Markdown. Again, I don't know about Neorg, but Org-mode in Emacs supports tons of interesting things that don't exist in Markdown, - things like "smart" datetime stamps where you can calculate the difference between dates, change the date and it would automatically adjust the day of week, or pick a date using the calendar UI;
- it supports time clocking - you can for example use pomodoro to automatically clock you in and out for each task, and then later build a time report, showing you how much time you spent on each task;
- priorities and tags; habit tracking and task management;
- tables that you can use like spreadsheets in Excel - can you do calculations in your Markdown tables?;
- embedded LaTeX snippets - indispensable if you need formulas and stuff;
- exporting to many different formats - e.g., you can easily turn your notes into a reveal.js presentation;
And of course code blocks. But not just static code blocks, you can run them and see the results. Moreover, you can for instance run some curl command, pipe the results into a javascript code block, then results of that calculation pipe into a python block and finally into some other backend that generates a graph.
In addition, there are tons of plugins you can use for example to automatically git commit your notes. Or have Zettelkasten system like in Roamresearch, Loqseq or Obsidian. You can keep your pdf annotations that automatically sync with the book, or keep notes to a codebase, where each note correlates to specific file, line or function in your code. Or you can manage your Anki cards to help you retain information - your notes and the anki cards would be the same, you wouldn't have to store and maintain the same info in two different places.
So, my suggestion is that before dismissing any tool that doesn't look very familiar to you or the majority of your peers, maybe first try to understand why some people choose to use that tool, even though it seems to contradict more popular choice.
https://raw.githubusercontent.com/nvim-neorg/norg-specs/main...
Furthermore, each item you have listed as a benefit to Org-mode is in fact capable of being done in Markdown via plugins for neovim, and probably other markdown editors, like Loqseq, Roamresearch, or Obisidian, much in the same way you speak of plugins that interface with .org docs.
https://github.com/wthollingsworth/pomodoro.nvim
https://github.com/Myzel394/easytables.nvim
https://github.com/vimwiki/vimwiki
So, my suggestion is that before dismissing a comment regarding a plugin that is unfamiliar to you, is to read its spec, and then try to understand why people would be perhaps dismissive of that tool, especially when it chooses to conflict with existing, more popular choices.
Okay, I admit I assumed that prematurely. I do stand by my words though - Org-mode in Emacs is much more capable than Markdown in any other editor or a specialized tool I have seen. Emacs is not without flaws, and Org-mode also has weaknesses. Sometimes Markdown is a better tool for certain things, but when strictly comparing capabilities and potential, Org-mode would be ahead. Anyone who has used it sufficiently would attest to that.
The problem is neorg is neither Markdown nor Org and I'm not bothering to use a one-off format for this one tool.
- Literate programming can be done in Jupyter Notebooks, R Markdown, and other computational notebooks.
- Advanced to-do tracking, agenda views, and tagging are available in productivity tools like Asana, Trello, and Todoist.
- Customizable exports can be done in many document preparation systems like LaTeX or pandoc.
- Spreadsheets and calculations are, of course, native to Excel and Google Sheets.
However, the real power of org-mode - and what makes it stand out - lies in the integration and synergy of all these components in one place, inside a powerful text editor (Emacs). This tight integration is harder to achieve when you're using various separate tools to accomplish the same tasks.
It not only makes org-mode a versatile tool for many text-related tasks (note-taking, programming, writing papers, planning projects, managing to-dos), but also allows these tasks to naturally intertwine and interact. For example, you could extract to-dos directly from your code comments, or include executable code snippets in your project plan.
Moreover, as a component of Emacs, org-mode can tap into the vast ecosystem of Emacs plugins and extensions, meaning you can further extend its capabilities to suit your particular needs.
So, while it's true that many of these individual features can be found elsewhere, the unique combination and integration offered by org-mode give it a singular and valuable position in the tools landscape.
> Markdown is unrivaled.
Respectfully, I disagree. Yes, Markdown is more popular. Yet, in the hands of an experienced Emacs user, things that are possible to do with Org-mode can sometimes be on another level of awesome. You just probably haven't seen it.
The tooling for Emacs is unrivaled. Markdown is, honestly, pretty cool: it’s probably the best thing the John Gruber has ever done. I think that it’s arguable that Markdown will survive everyone now alive on Earth.
But I believe that Emacs will last longer still, because Emacs is not a text format but a powerful user-extensible environment. As long as general-purpose computers are legal, folks will use something recognisable as an Emacs.