8 ms·
Org Mode Is One of the Most Reasonable Markup Languages to Use for Text (2017)
- tlackemann 5y agoorg-mode appears to be thriving these days, or always was, but either way I'm really glad to see. I only picked up emacs last year after being a die-hard vim user for 8+ years and org-mode was a large reason why. I wanted to learn how to manage todos and documentation alongside my code - it's incredible. Lifechanging. The only negative is trying to teach others to use this workflow. I haven't found a tool yet that can easily transform todos in org-mode into something a product manager could use. Exporting to HTML makes sharing docs a breeze. Maybe workflow tools are a rarer use-case or I just haven't dug far enough. Either way, org-mode definitely worth learning in 2021
- gpderetta 5y agoHum, org has built-in export/publish to (among other things) html. You can add inline .css as required. What it is missing?
- tlackemann 5y agoI'm aware but rereading it was unclear. I more was asking/bantering about todos. Sharing docs via HTML export is great
- deleted 5y ago[deleted]
- nanna 5y agoHow about org's taskjuggler export?
- tlackemann 5y agoAh see! I haven't dug deep enough. Thank you kindly, eager to dive into that
- nanna 5y agoTo me it's a great example of why Org can't be compared to Markdown. On the one hand you just have a humanly-readable plain text file. On the other it is also a spreadsheet. On the other it is also the interface to a complex Gannt chart. Org files are multidimensional; Markdown files can merely be exported to a variety of formats.
- aidenn0 5y agoI haven't used it in many years, but there were plenty of org-mode <something else> two-way sync packages. I used the Trello one for a bit long ago.
- gpderetta 5y agoI have used org mode to track team status and generate pretty reports and has been reasonably useful. But what I would want to use it for is literate programming, at least for my own personal projects. Or at the very least as a jupyter notebook replacement (python-mode + elpy is already a decent enough replacement ATM). One day I'll set things up properly.
- bananadonkey 5y agoI do this for homelab automation using org-babel, it's great. I am yet to use tangle for anything real like dotfiles or such.
- bloopernova 5y agoI keep meaning to work on an JSON to elisp object importer. I work a fair bit with AWS, and the command line utility can output results in JSON. Being able to reference and mess with that output in org-babel and org-mode tables would be great.
- gpderetta 5y agoThese days [1] emacs has built-in json support, as it is needed for a decent LSP experience. [1] as in, you need to build it yourself from HEAD.
- searene 5y agoI think the biggest advantage of Org Mode over Markdown is that Org Mode can attach properties to headers. This seems trivial, but it's not. Because of that, you can: 1. Give a header an id and jump to it from anywhere. 2. Attach scheduling information to the header so that you can easily track TODOs and DONEs. I usually further break down a TODO into several sub-TODOs and write something under each one to organize my thoughts, including code blocks, tables, quotes, footnotes, which is impossible in Markdown. 3. You can attach anything else to it, too. I also attach an Anki note ID to it and use Org Mode as an alternative Anki editing environment. Because of the attached note ID, I can easily distinguish whether I want to create a new Anki card (without an ID) or update an existing one (with an ID). That is also hard to implement in Markdown (Strictly speaking, I don't think it's even possible to implement it in Markdown). My only complaint is that Emacs is the only text editor that fully supports Org Mode. Other editors (e.g. vim, VSCode) support it too, with only to an extent. Sometimes I also wonder why Org Mode is not as popular as Markdown, the former is far more powerful.
- nanna 5y ago> Sometimes I also wonder why Org Mode is not as popular as Markdown, the former is far more powerful. Because it's so integrated with Emacs, and all other editors are second class citizens (/hosts)?
- mumblemumble 5y agoAlso, it's kind of right there in the name. "Org Mode". It's not just a markup format, it's an emacs mode. My org files quickly accumulate custom elisp snippets for automating small one-off things like rendering embedded dot with Graphviz and displaying them inline. I don't think I'm alone in that. Unfortunately, that creates a situation where, whenever I try to work with org files in other editors, there's a certain "it's like opening Photoshop files in MS Paint" aspect to the experience. Too many things that I've come to take for granted about how I'd interact with and edit these files no longer works. Markdown, on the other hand, is just a markup format. It has lots of dialects, but it isn't really owned by anyone. That creates a very different power structure: Markdown editors are free to just try to make a good Markdown editing/viewing experience, whatever that means to that particular editor's developer. There's no looming and inevitably unfavorable comparison to the format's native editor to have to contend with.
- vemv 5y agoFairly long-time Emacser/Lisper here. Personally I've never bothered mastering org-mode; using Emacs has never been a goal in itself for me. In practice, org-mode in a team context barely scales because: * it's a practically unparseable language: all interop libs (like those found for Clojure, Ruby, Haskell, etc) seem to have severe limitations parsing/emitting org-mode. * Related to the previous point, it means one can't create .org files automatedly, from a CI pipeline. This makes it hard to have documentation guaranteedly up-to-date, out of a codebase. * Sooner or later, at least a few people in a team won't be exactly org-mode fans (even in all-Emacs teams; I've belonged to a few). * Lastly, github itself doesn't excel at rendering .org files - one can still find artifacts. My take would be that if org-mode works for you - awesome! But please consider the impact of introducing it at work. Early successes can be deceiving.
- JoelMcCracken 5y agoHonestly, I agree. I understand that pandoc can convert to/from org files, but I'm sure that conversion is lossy (i don't know how it could possibly not be). I love org mode, but i think its best used by individuals. Now maybe if someone decided to standardize it, things would be different, but as it stands, don't use it on teams. However, for your own, personal stuff, i think its great. For example I use org-roam to manage my knowledge base. This is an inherently personal pursuit so I'm not worried about using it for this purpose.
- alpaca128 5y agoOrg-Mode is a great concept but looking at the syntax you can see its age. I think it would be cool to have a format comparable to Markdown but with support for a JSON-like object notation that supports the linking of any metadata to any part of the text. That would make it simpler and let users add their own properties which would then be just ignored by other parsers. The problem with such things is of course that we already have what feels like a hundred different Markdown variants, each one slightly different and incompatible with the others in some way. That is in fact the reason I started using .org in the first place as a Vim user (that and the LaTeX code support).
- 5y ago
- john-doe 5y agoI miss Textile.
- BeFlatXIII 5y agoSame here. In particular, the Textile way of making headings is far better than MD. The one thing I dislike about Textile is that it insists on treating all line breaks as <br>, which makes it awkward to edit in vim because it encourages long lines.
- vzaliva 5y agoMany people do not realize that if you put a file named README.org in top directory of github project, github web UI will render it and show it when project page is displayed.
- zora_goron 5y agoFor all my personal GitHub projects, I've been using a `README.org` file instead of the default `README.md`!
- Jtsummers 5y agoThat was actually a reason I never used my sr.ht account. I like my README.org files.
- clircle 5y agoI think HN is averaging about one high quality Emacs post a week these days. Emacs renaissance?
- TOGoS 5y agoGigascale software projects with thousands of engineers and a hundred layers of abstraction (half of which nobody understands and they only work simultaneously 2 days out of the year) got everyone burnt out. Messing around in bespoke, home-grown computing environments made out of text files that you wrote yourself is grounding, like growing your own vegetables, and we all need that more than ever these days.
- User23 5y agoI’ve been using Emacs for the better part of three decades and it’s never had a stronger community. It may not be the most popular thing, but it draws extremely high quality people and that’s paid great dividends for the user community. And piggybacking off the LSP has been a great advance too.
- taeric 5y agoIt is telling that most of the complaints on org-mode seem to be from folks that haven't used it. And never intend to use it. Mainly because of emacs. Which is a shame. I think Jupyter mainly steals a ton of market from Mathematica and Matlab, without most of it's users ever having seen those offerings. Org has the advantage that it is not tied to any specific extension language. It is all a cdata style delimited text block with contacts on environment setup and tear down. With the output being fair have for editing.
- mhd 5y agoOnce upon a time, I quite enjoyed writing in Perl's POD format. It's not really a "hidden" markup language like Markdown or (partially) org, but it still had way less overhead than XML or BBCode. =head1 This is a major headline =head2 And a secondary one. Paragraphs end with blank lines, as with many other markup systems. And you can use I<emphasize> B<Text> with inline codes, including some richer than the usual italics/bold, like e.g. for F<filenames.txt>. Doesn't serve the dual purpose of both being a source of translation and being read verbatim without the reader knowing that it's a markup language, but honestly, you get used to stuff like that easily. Rebol's MakeDoc also was quite neat, and had a very minimal implementation. Man, so much lost potential with that language.
- BeFlatXIII 5y ago> still had way less overhead than XML or BBCode That's why I like Textile and Markdown so much. If I'm going to type out all the overhead tags, just like me go full-on LaTeX.