Welcome to Ourbigbook version 0.9.6! Here's the table of contents:

1. Internal cross file references

words: 45 articles: 2
Here is a link to a header present in another file: h2 not in the README.
Explicit macro equivalent, but with a "Section" prefix: Section 1.1.1. "h2 not in the README".
And below this line, we actually include the toplevel header of the other file.
This section is present in another page, follow this link to view it.
In mathematics mathematics I really like the fundamental theorem of calculus.
My first paragraph is amazing!
Implicit link with body equals URL: examle.com This works because we automatically recognize the https:// prefix.
Implicit link with custom body: example website
Implicit link immediately followed by a period by using an empty argument: examle.com. After period.
Explicit link with \a[]: example website
And the second one with inline code f(){} and inline server-side rendered maths with KaTeX: .
But if we want block code here it is
f() {
  return 1;
and here is some block maths:
Ciro loves maths, and so equations can have titles, and references to math equations just work! See e.g.: Equation 2. "This is my favorite equation in the entire world!!!"
Equation 2. This is my favorite equation in the entire world!!!
We try to make anything escapable with a backslash, e.g.:
  • literal backslash \notmacro
  • code and math: ` and $
If you want more than three backticks in your insane code block, you can add more to the open:
Here  are three backticks:
or you can also use the equivalent sane macro literals. When you open and close a macro argument with more than one square bracket [ or curly brackets {, it becomes a literal string and does not get parsed further:
Here  are three backticks:
And here's an example of named title= argument with multiple curly brackets { which makes its content literal:
Ourbigbook Template
Meh, the usual. Insane list:
  • first item
  • second item
    • some nesting
    • and some more
  • third item
Sane list with explicit Ul:
  • first item
  • second item
And now for tables, see this one: Table 1. "My table title". Try clicking next to the headers to sort the columns!
Table 1. My table title.
String colInteger colFloat col
To escape the insane lists and tables just backslash them as usual:
* not a list
| not a table
And a quotation:
To be or not to be!
Ourbigbook is the answer.

5. References, headers, images

words: 149 articles: 14
Ciro loves headers and headers!
Reference to a header: paragraphs, links, code, math.
Make it show the section number as well with {full}: Section 3. "Paragraphs, links, code, math".
The following header is set to be uppercase by default due to the {c} (upperCase): Ciro is awesome
This one isn't however: banana. But we can change:
Reference to the following image: Figure 1. "Xi Chrysanthemum is a very nice image".
Figure 1. Xi Chrysanthemum is a very nice image. Source.
An YouTube video: Video 1. "Sample YouTube video.".
Video 1. Sample YouTube video. Source.

5.3. Unlimited header levels?!

words: 72 articles: 11

5.3.1. My h4

words: 72 articles: 10 My h5
words: 72 articles: 9 My h6
words: 72 articles: 8 My h7
words: 72 articles: 7 My h8
words: 72 articles: 6 My h9
words: 72 articles: 5
The parent of this header is determined by specifying it's ID with:
rather than by the number of = signs of this header.
This means that you don't need to worry about counting equal signs anymore!
And it is much easier to move large chunks of headers around! You only need to change the {parent=} of the toplevel one.
This is why when creating large documents, you should use parent exclusively.
You can use the {child} or {parent} arguments of a link to tags headers with the current header.
These will show up on the metadata of a given header.
Note that metadata is only visible when the header is the toplevel header of a page, otherwise it would clutter your headers too much, so it is not very easy to see in this single page example.
But all headers get their own toplevel pages when using split headers: docs.ourbigbook.com/split-headers

6.1. Animal

words: 10 articles: 6

6.1.2. Cow

words: 6
Oh, and cows are also mammals.
Bats can fly.
But cats can't.

6.1.4. Mammal

articles: 2