Org mode a short overview

Org mode is really good at helping you write plain text documents, but then there is actually a lot of power behind the scenes a bit like markdown, just a bit different. Also the exporting is just amazing, if you need something beyond the already available export options there are plenty options in the repositories to find other ways to export your document.

Org mode is only amazing at scheduling tasks for particular days, if you need to do something specific day, you can schedule it, but if you have a deadline org-mode also can do deadlines. recurring tasks are no problem either, you can specify how many days, weeks, months or years you want in between.

To insert a day type C-c . and choose the day you want to insert, you can get the menu up and type next mon and org will understand what you mean, but that is just inserting a date like <2021-02-23 Tue> if you want to schedule something about a task (coming up) you would type C-c C-s for time schedule and for deadline is C-c C-d.

Any header in a org-mode document can be a task (asterisks indicate header). roughly equal to # in markdown.

You might not be familiar with this, it is a pretty old idea, but it never really caught on literate coding is the idea that you not only write code, but you write the documentation along side the code with small blocks of code being interspersed along the documentation, then when you have a nice document the idea is that you can extract all the code, either block by block or you referred to other blocks while you were writing the code, then it can be automated how to extract all the code and put it into files across your entire file system.

The same goes for your documentation this can be extracted as well, but when you do this all the code will stay and in better system show up in code boxes, so that you can see the code, and the relevant information right next to it. This can be a very powerful thing, but it does incur a somewhat bigger cost of maintainance, on the other hand your documentation will possibly make it easier to maintain the code. Anyway org-mode has very good support for working in this style.

print("hello, world.")
print("This is python")

That is what a code block looks like, I can make this write out to a file anywhere on my system. But I can also give this block a name and refer to it in other blogs building more complex software.

Also when working with org mode, the print statement will in fact not do what you expect, and you cannot really do multiple outputs, if you expect to see any output from your block the way it needs to be done is like

return ("Hello, World\n This is python")

since print 'ing is a commandline thing and there is no commandline in org, also with the way it is running this makes sense.

When you run a snippet of code in org-mode like this, you are asking the language to evaluate the snippet, then returning to org-mode, therefore the code is completed when you get back so return makes sense.