# Markdown Extensions

> Strikethrough, description lists, footnotes, highlight, TOC, smart punctuation

---

> **Warning:** Please keep in mind when using these extensions, you are deviating from the smallest common markdown dialect set. If the library used to render markdown in HTML needs to be changed for any reason, there is a possibility that not all of the extended markup used here will be supported (see also [#32](https://codeberg.org/bschwede/linkenhancer/issues/32)). Since the markup is not intrusive, the impact should not be serious — of course, it's a minor drawback.

The package [League\CommonMarkdown](https://commonmark.thephpleague.com/) used for processing Markdown texts offers several useful extensions that can be activated optionally:

- [Strikethrough](https://commonmark.thephpleague.com/2.x/extensions/strikethrough/)
- [Description Lists](https://commonmark.thephpleague.com/2.x/extensions/description-lists/)
- [Footnotes](https://commonmark.thephpleague.com/2.x/extensions/footnotes/)
- [Highlight](https://commonmark.thephpleague.com/2.x/extensions/highlight/) (available with CommonMark v2.8.0 / webtrees v2.2.5)
- [Table of contents](https://commonmark.thephpleague.com/2.x/extensions/table-of-contents/) along with [Heading Permalinks](https://commonmark.thephpleague.com/2.x/extensions/heading-permalinks/)
- [Smart Punctuation](https://commonmark.thephpleague.com/2.x/extensions/smart-punctuation/)

You can activate all or a few selected of these extensions. As far as possible they are of course integrated with the markdown editor and you find additional information in the markdown help.

### Footnotes

Footnotes can be placed near their references (there can be one or many references to one footnote) or everywhere you want. For the overview, it is advisable to place them at the bottom. When rendering, the footnote container resides at the end of the content.

### Table of Contents

If your text is structured with headings, it is a good choice to activate the table of contents extension. The table of contents is generated automatically and included into the content above the very first heading or instead of a placeholder.