beorg 3.29.0

There are two headline new features in this release:

This releases allows beorg to be more flexible in how .org files are formatted. By default beorg will now add a blank line above each headline, but respect manually edited files that have more or less blank lines above headlines.

There are two new Scheme variables, which you can customize in your init.org file, or using the new customization UI:

#+begin_src scheme

(defvar beorg-auto-lines-before-headlines #f

 "If #t then beorg will automatically add newlines before headlines, depending on the value of beorg-newlines-before-headlines. If #f then beorg will respect the number of lines before headlines already in a file, and only use beorg-newlines-before-headlines for new items.")

(defvar beorg-newlines-before-headlines '(1)

 "The first item in this list is the number of blank lines to add before a first level headline, the second item the number of blank lines before a second level heading, etc. The last item in the list is the number of blank lines to add before all other headlines.")

#+end_src

The following in your init.org…

#+begin_src
(set! beorg-auto-lines-before-headlines #t)
(set! beorg-newlines-before-headlines '(3 2 1 0))
#+end_src

would auto-format files (i.e. disregard manually entered blank lines between headlines) and automatically add 3 blank lines before a first level headlines, 2 blank lines before a second level headline, 1 blank line before a third level headline and 0 blank lines for all other levels.

Download now for iPhone and iPad

Follow us on Mastodon and Bluesky

Privacy Policy | Press Kit