-
Notifications
You must be signed in to change notification settings - Fork 35
Blocks
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-blocks do miss some sanitizing:
HTML chars | Int. L. | Ext. L. | Text Format | URL Ampersands | Pandoc | Templates involved |
---|---|---|---|---|---|---|
x | #NAME# |
Note: lazyblorg looks into block_type_export_backend
which holds
either HTML
or LATEX
.
HTML-blocks do miss some sanitizing:
HTML chars | Int. L. | Ext. L. | Text Format | URL Ampersands | Pandoc | Templates involved |
---|---|---|---|---|---|---|
x | #NAME# |
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.
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 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-blocks do miss some sanitizing:
HTML chars | Int. L. | Ext. L. | Text Format | URL Ampersands | Pandoc | Templates involved |
---|---|---|---|---|---|---|
x | #NAME# |
HTML chars | Int. L. | Ext. L. | Text Format | URL Ampersands | Pandoc | Templates involved |
---|---|---|---|---|---|---|
x | x | x | x | #NAME# |
HTML chars | Int. L. | Ext. L. | Text Format | URL Ampersands | Pandoc | Templates involved |
---|---|---|---|---|---|---|
x | x | x | x | #NAME# |
Parsed but has no effect. Raise an issue or send a merge request in case you need it.
Not parsed, causing an error. Raise an issue or send a merge request in case you need it.
Using lazyblorg:
- Page Types (must-read)
- Orgmode Elements (must-read)
- FAQs
- Roadmap
- Project Origin
- Similar Projects
Coding: