capybara/doc/extensions.md

# changes made from the default rendering of racket markdown

code blocks have syntax highlighting baked by pygments. additionally, tex-style math expressions are
baked to mathml using mathjax-node (this requires a polyfill on google chrome, which is filled in by
nginx)

# extensions provided on top of regular racket markdown

## front matter

front matter is an s-expr

example

```
((date 2021 06 06)
 (title "meow!")
 (summary "the summary")
 (tags "WaterDrinkers" "drinking" "water")
 (authors "haskal"))

regular markdown content here
```

front matter is required. if you have no front matter to provide, use an empty list:

```
()

page content here
```

## hashtags

a hashtag `#hashtag` appearing anywhere except in code and math blocks will be converted to a
hashtag link which leads to an aggregate of all pages that use that tag (in the `tags` metadata)

## xrefs

pages go into a hierarchy based on their folders and a slug derived from markdown filename - except
for `index.md` which becomes the index in a certain folder. xrefs are a way to refer to slugs.
xref can appear in links as follows

```
[some link](^some/page/xref)
```

## user links

user pages can be linked to either with a freestanding mention or a link

```
@haskal

[link to haskal](@haskal)
```

## tech terms

like scribble docs, technical terms can be defined and referenced. currently you need to stem
manually using the `key` attribute

```
<deftech key="florp">florps</deftech> are like stars, but shaped like a floppy disk

...

i <tech key="florp">florped</tech> the post
```

## masto

uwu

```
<masto>https://cybre.space/@haskal/106372557156109664</masto>
```