2025
7
14
https://graft.sirref.org/graft-0004/
graft-0004
/graft-0004/
Forester Code Blocks
The markdown syntax cannot do everything that Forester can. For example, how might you transclude another tree into your tree?
At any given moment, you can escape into Forester syntax by using a code block where the infostring is forester. Graft will translate this into Forester syntax and output it in the same location as the code block in the generated code.
References
Context
2025
7
14
https://graft.sirref.org/graft-0001/
graft-0001
/graft-0001/
Markdown Syntax
The markdown syntax is the core feature of Graft. It supports most of what Forester has to offer. It uses a Jekyll format frontmatter to provide Forester metadata and supports special code blocks too.
2025
7
14
https://graft.sirref.org/graft-0003/
graft-0003
/graft-0003/
YAML Frontmatter
The markdown format for Graft follows the Jekyll-style YAML frontmatter format. For example:
will generate a tree with title and date metadata with a single paragraph of text.
To insert meta field into your tree, you can use a nested object in your YAML frontmatter.
There is no centralised documentation on these meta but this biographical tree example may be useful
2025
7
15
https://graft.sirref.org/graft-0008/
graft-0008
/graft-0008/
Subheadings are subtrees
Markdown headings are automatically transformed into "anonymous subtrees"
2025
7
15
Anonymous!
Just like that. It means they allow authors to provide structure without adhering to the atomicity principles.
2025
7
15
Interaction with Forester Subtrees
Markdown sections delimited by headings have no "closing tag". This means you that you don't quite get the nice feature of Forester where subtrees can be a standalone thing inside another text. Furthermore, including a subtree
2025
7
15
https://graft.sirref.org/named-subtrees/
named-subtrees
/named-subtrees/
Named subtrees
Sometimes you don't want to create a new file just to have a referenceable tree. In this case, you want a named subtree. In the markdown syntax you can use markdown heading IDs to name your subtrees. For example this section has the following heading:
2025
7
14
https://graft.sirref.org/graft-0004/
graft-0004
/graft-0004/
Forester Code Blocks
The markdown syntax cannot do everything that Forester can. For example, how might you transclude another tree into your tree?
At any given moment, you can escape into Forester syntax by using a code block where the infostring is forester. Graft will translate this into Forester syntax and output it in the same location as the code block in the generated code.
2025
7
14
https://graft.sirref.org/graft-0005/
graft-0005
/graft-0005/
Other Special Code Blocks
by Graft.
ocaml code blocks will be run through hilite and converted to HTML.
2025
7
16
https://graft.sirref.org/graft-0007/
graft-0007
/graft-0007/
Verbatim HTML
Using markdown's HTML blocks, you can add HTML directly into your tree.
For example you could embed a marquee element by writing.
]]>
This is a marquee element!
Backlinks
Related
Contributions