# Markdown and diagrams
GitHub-flavoured Markdown with raw HTML and highlighted code, and `mermaid`
fences drawn as diagrams whose boxes are links.
<Example>
| site | a docs website |
| doc | a Word document |
- [x] tables, task lists, footnotes
</Example>
```mermaid
flowchart LR
md["Markdown"] --> page["A page"]
click page href "../boxes/viewer/diagrams/README.md" "Diagrams"
```
Teaches it: [Markdown that works](../boxes/viewer/writing-a-document/markdown-that-works/README.md),
[Diagrams](../boxes/viewer/diagrams/README.md).