If you already use Markdown then the Org mode syntax will seem very familiar.
This is an overview of some of the basic Org mode syntax compared to Markdown. If you want to learn more check out the Org mode manual.
Headings in Markdown are known as headlines in Org mode.
# Heading 1 ## Subheading 1.1 ### Sub-subheading 1.1.1 ## Subheading 1.2 # Heading 2 Some notes
The same in an Org file:
* Headline 1 ** Headline 1.1 *** Headline 1.1.1 ** Headline 1.2 * Headline 2 Some notes
Markdown and Org mode lists are almost identical - except that you can’t use *’s to start Org mode list items (as they are used by headlines):
A list which works in Markdown and Org mode: + Item 1 + Item 2 + Item 2.1 + Item 2.2 A numbered list which works in both: 1. Item 1 2. Item 2 3. Item 3
There are a few differences here:
The word **bold** will be in bold. The word *italics* will be in italics. ~~This has been struck out~~.
The word *bold* will be in bold. The word /italics/ will be in italics. +This has been struck out+.
In my opinion Org mode links are much nicer, and have an easier to understand syntax. In Markdown it is easy to forget whether it is square brackets first or parentheses.
[beorg, an iOS app which works with Org mode files](https://beorgapp.com)
[[https://beorgapp.com][beorg, an iOS app which works with Org mode files]]
This is where Org mode leaps over Markdown in terms of functionality. If you use Org mode in Emacs then tables are actually fun to work with. Emacs will automatically maintain column widths, add new cells, insert/delete rows/columns and even act as a mini spreadsheet. Markdown on the other hand relies on extensions for table support and there are a few variants.
If you are a Markdown user who is interested in how Org mode tables work take a look at the extensive documentation.