@@ -39,6 +39,35 @@ Linking between pages is possible, adress them by their relative adress in the `
```markdown
Find more info on the [syntax](/docs/syntax) page.
```
### Linking within pages / Heading anchors
The [Heading anchor](https://github.com/atlassian/commonmark-java#heading-anchor) extension is activated which generates IDs for heading elements. Which could be used as anchors, this means that you can link to them.
which means the ID will be lowercase with hyphens (`-`) instead of spaces. So you can link to them in Markdown like
Siehe [Kapitel 1](#eine-überschrift) und [Kapitel 1.1](#eine-unterüberschrift)
Which allwos creation of a TOC for example. You can also reference headings or subheadings on other pages
see the [voyant-example](/docs/voyant#beispiel)
If you are unsure which ID was generated for a heading inspect the element with the developer tool of your web browser. In Firefox for example you can do this with a click on the heading and the context menu entry "Inspect Element"("Element untersuchen"), which will reveal the id:

### Images
...
...
@@ -48,7 +77,13 @@ There is no place for placing own images yet, I will work on it and update this
For parsing Markdwon and rendering HTML the [commonmark-java](https://github.com/atlassian/commonmark-java) library is used. Currently implemented by this library is the [CommonMark Spec 0.29](https://spec.commonmark.org/0.29/). Look at the [CommonMark Dingus](http://spec.commonmark.org/dingus/) for testing and previewing the syntax.
Currently there are no extensions activated, but there are some [available](https://github.com/atlassian/commonmark-java#extensions), if you need one just ask.
Currently there are two extensions activated, there are some [more available](https://github.com/atlassian/commonmark-java#extensions), if you need one just ask.
*[YAML front matter](https://github.com/atlassian/commonmark-java#yaml-front-matter)
If there is a need for even more extensions or different syntax we may painlessly switch to [flexmark-java](https://github.com/vsch/flexmark-java) for parsing, which is a commonmark-java fork wich supports a lot more different markdown flavours and extensions.