Blocks - novoid/lazyblorg GitHub Wiki

Orgmode Elements > Blocks


Blocks must not be intended. They start with #+BEGIN_ followed by supported block types (below; case insensitive) and parameters. Blocks end with the first #+END found.

Optional names can pre-pended a block: lines starting with =#+NAME: = (case insensitive). Those names are used as captions for the blocks. Please note the different handling for HTML blocks.

Enforcing line breaks is not yet supported with lazyblorg. Open an issue if you need it.

SRC

SRC-blocks do miss some sanitizing:

HTML chars Int. L. Ext. L. Text Format URL Ampersands Pandoc Templates involved
x #NAME#

EXPORT

Note: lazyblorg looks into block_type_export_backend which holds either HTML or LATEX.

HTML

HTML-blocks do miss some sanitizing:

HTML chars Int. L. Ext. L. Text Format URL Ampersands Pandoc Templates involved
x #NAME#

Named HTML Blocks

If an HTML block has a name associated, it gets included into the blog article with a caption and the HTML source rendered as visible content.

#+NAME: This is the caption
#+BEGIN_EXPORT html
<a href="http://Karl-Voit.at">Link to my webpage</a>
#+END_EXPORT

… results in something similar to:

<a href="http://Karl-Voit.at">Link to my webpage</a>

The caption/name/title is omitted at the moment. See this related issue.

HTML Blocks Without a Name

If an HTML block has no name associated, its HTML source code is written as is into the HTML output of the blog article. This way, you can add HTML snippets for tweets, videos or other content directly into your lazyblorg article.

#+BEGIN_EXPORT html
<a href="http://Karl-Voit.at">Link to my webpage</a>
#+END_EXPORT

… results in something similar to: Link to my webpage

LATEX

LaTeX blocks are HTMLized via pandoc.

LaTeX-blocks do miss some sanitizing:

HTML chars Int. L. Ext. L. Text Format URL Ampersands Pandoc Templates involved
x x

EXAMPLE

EXAMPLE-blocks do miss some sanitizing:

HTML chars Int. L. Ext. L. Text Format URL Ampersands Pandoc Templates involved
x #NAME#

VERSE

HTML chars Int. L. Ext. L. Text Format URL Ampersands Pandoc Templates involved
x x x x #NAME#

QUOTE

HTML chars Int. L. Ext. L. Text Format URL Ampersands Pandoc Templates involved
x x x x #NAME#

CENTER

Parsed but has no effect. Raise an issue or send a merge request in case you need it.

ASCII

Not parsed, causing an error. Raise an issue or send a merge request in case you need it.

⚠️ **GitHub.com Fallback** ⚠️