Org-mode is an Emacs mode for note taking, project planing and making TODO lists (because we all need TODO lists to GTD). It can handle more things: Calendar, diary, agenda and export you Org documents to other file extensions. I am not going do talk about all can do with org-mode, you can google yourself for further information. I am going to focus in note taking and export.
The org file
It all starts with a file with a .org
extension. Create one in Doomemacs with SPC .
and name it "myfile.org". By default a template should fill the title like:
#+TITLE: Myfile
This is part of the heading of the document. Here you can specify some options like the author, email, date or disable the table of contents (toc).
#+AUTHOR: Some Author
#+EMAIL: Some@email.com
#+OPTIONS: toc:nil
After this, the body of the document begins. You start a headline with *
and two of them **
indicate a subheadline. You can specify verbatim text between ~|~
, code inside =|=
, italics surrounded by /|/
and bold text inside *|*
. (The | indicates the cursor position, or where you write your text).
* Heading 1
** Heading 1.1
This is ~verbatim~, =code=, /italics/, *bold* and _underlined_ as well.
Lists and TODO's
For simple bullet list you can start it with:
- Item one
- Item 2
or numbered list
1. First.
2. Second.
The cool thing, is that pressing Alt-RET
(alt-enter) will automatically take you to the next line keeping the counting of the items (e.g. If you are in item "2. Second" and press Alt-RET
the next item will be "3. |").
To insert a TODO just type: "* Buy milk" and then press SPC m t t
to mark it as a TODO. Or press Shift-Right/Left
to change the state from "TODO" to "DONE"
* TODO Buy milk.
* WAIT Get money to but milk.
* DONE Get a Job.
Blocks, comments & quotes
To start a block just write (ignore the "." at the beginning):
.#+BEGIN_SRC NameOfTheLanguageCode
.#+END_SRC
Quotes and comments are similar
#+begin_quote
#+end_quote
#+BEGIN_COMMENT
#+END_COMMENT
Tables, figures & links
Yes, we can have tables. Use "|" and type "name", again "|", type "Phone" and press TAB
. You will see how Emacs starts to arrange the table fitting automatically the width according to the content.
| Name | Phone | Age |
|-------+-------+-----|
| Peter | 1234 | 17 |
| Anna | 4321 | 25 |
Inserting a figure is simple as typing: [[/path/to/the/image][desciption]]
. If you press zi
in DoomEmacs it will call the function org-toggle-inline-images
and will display the image you set in the document.
The same syntax is used for the links, just type: [[url][desciption]]
In DoomEmacs you can press SPC m l l
to insert links and files/images.
Final thoughts
The great thing about org-mode is that you can fold/unfold the sections of the document, to navigate quickly trough the notes, and export this plain text document (Yes, if you open the org file in a notepad you will see just plain text, is Emacs that renders the plain text) to a more common document types such as:
- Org document –> LaTeX document -> PDF document.
- Org document –> ODT document (the free alternative to Microsoft doc files, look at LibreOffice project).
- Org document –> Markdown document (another plain text format).
- Org document –> html document.
- Org document –> Plain text document.
You can export from one to another document with Pandoc, which was meant to convert from Markdown to any type of document. As the Pandoc's page says:
If you need to convert files from one markup format into another, pandoc is your swiss-army knife. Pandoc can convert between the following formats.
And there are several formats. However, for simple day-life PDF, html, ODT and plain text (for emails) the Emacs org-export works fine.
As an example, an org document can look like this
If you found this content useful, please support me:
BTC: 1E2YjL6ysiPxRF4AEdXChpzpesRuyzgE1y