4.23 Option for org-mode block styles

Brief: Set the overall style of Org code blocks, quotes, and the like.

Symbol: modus-themes-org-blocks (‘choice’ type)

Possible values:

  1. nil (default)
  2. gray-background (value grayscale exists for backward compatibility)
  3. tinted-background (value rainbow exists for backward compatibility)

Nil (the default) means that the block has no background of its own: it uses the one that applies to the rest of the buffer. In this case, the delimiter lines have a gray color for their text, making them look exactly like all other Org properties.

Option gray-background applies a subtle gray background to the block’s contents. It also affects the begin and end lines of the block as they get another shade of gray as their background, which differentiates them from the contents of the block. All background colors extend to the edge of the window, giving the area a rectangular, “blocky” presentation.

Option tinted-background uses a slightly colored background for the contents of the block. The exact color will depend on the programming language and is controlled by the variable org-src-block-faces (refer to the theme’s source code for the current association list). For this to take effect, the Org buffer needs to be restarted with org-mode-restart. In this scenario, it may be better to inhibit the extension of the delimiter lines’ background to the edge of the window because Org does not provide a mechanism to update their colors depending on the contents of the block. Disable the extension of such backgrounds by setting org-fontify-whole-block-delimiter-line to nil.

Code blocks use their major mode’s colors only when the variable org-src-fontify-natively is non-nil. While quote/verse blocks require setting org-fontify-quote-and-verse-blocks to a non-nil value.

Update Org block delimiter fontification.

Older versions of the themes provided options grayscale (or greyscale) and rainbow. Those will continue to work as they are aliases for gray-background and tinted-background, respectively.