17 — Advanced Markdown

Chapter 06 covers the basics. This chapter is the extras this server also renders — every one of them was tried on this installation.

Task lists

- [x] draft written
- [ ] waiting for review

Works in issues and in .md files; the boxes are shown read-only.

Emoji shortcodes

:tada: :rocket: :warning:

Renders as 🎉 🚀 ⚠️. Pasting the emoji directly works too.

Footnotes

This claim has a source[^1]

[^1]: Where the claim comes from.

You get a superscript number in the text and a linked note at the bottom of the page.

Maths

Inline $E = mc^2$ , or a block:

```math
\frac{a}{b} = c
```

Formulas are typeset in the browser; the source stays plain text, so git diff remains readable.

Diagrams

```mermaid
graph TD
  A[Request] --> B{Approved?}
  B -- yes --> C[Merge]
  B -- no --> D[Revise]
```

Flow, sequence and Gantt diagrams are drawn from text. Because you keep no image file, the diagram is versioned too — you see the change in git diff.

Tables, strikethrough, autolinks

| Column | Meaning |
|--------|---------|
| `main` | default branch |

~~dropped~~ and a bare address: https://forge.kabaforce.com

An address turns into a link even without brackets.

Referring to issues and people

In issues and comment boxes:

#12 → links to that issue
@username → links to the person and notifies them
Fixes #12 in a commit summary → closes the issue when the change reaches main (chapter 11)

Where each thing works

Place	Note
`.md` files	All of it; `readme.md` is shown automatically on its folder page
Issues and comments	All of it, plus you can drag files in as attachments
Wiki pages	All of it, with their own history (chapter 11)
Release notes	All of it (chapter 12)

Two habits worth keeping

Use the preview tab — before committing you see exactly what others will.
One sentence per line in long documents — differences read line by line instead of turning a whole paragraph red and green.