# Reference

This branch is deliberately dry. Everywhere else on this site tries to teach you something; these pages exist so you can look one fact up and get back to work.

If you are choosing a language rather than looking one up, [Diagram types](https://help.gocapable.com/diagrams/diagram-types.html) is organised by what you want to draw.

---

## What is in here

[Diagram languagesAll thirty-one, with worked examples.](https://help.gocapable.com/diagrams/diagram-languages.html)

[Notation referenceEvery BPMN and DMN symbol.](https://help.gocapable.com/diagrams/notation-reference.html)

[Diagram macro referenceEvery field on the macro.](https://help.gocapable.com/diagrams/diagram-macro-reference.html)

[Diagram engine versionsWhat draws each language.](https://help.gocapable.com/diagrams/diagram-engine-versions.html)

[File types and extensionsHow the language is decided.](https://help.gocapable.com/diagrams/file-types-and-extensions.html)

[Rendering limitsSizes, timeouts and anonymous readers.](https://help.gocapable.com/diagrams/rendering-limits.html)

---

## The three questions this branch answers

| **Question**                                  | **Page**                  |
| --------------------------------------------- | ------------------------- |
| Which language should I write this in?        | Diagram languages         |
| Why does my diagram look the wrong size?      | Diagram macro reference   |
| Why did my import come out as the wrong type? | File types and extensions |

---

## Everything under here

[Diagram languagesDiagram languages: the types in this family, and the editor or language we recommend for each.](https://help.gocapable.com/diagrams/diagram-languages.html)[Notation referenceNotation reference: the types in this family, and the editor or language we recommend for each.](https://help.gocapable.com/diagrams/notation-reference.html)[Diagram macro referenceEvery field on the diagram macro: display mode, alignment, height, border, scrolling, smart scale and dark mode.](https://help.gocapable.com/diagrams/diagram-macro-reference.html)[Diagram engine versionsWhich engine draws each language and which version is pinned, for the render service and the in browser editors.](https://help.gocapable.com/diagrams/diagram-engine-versions.html)[File types and extensionsWhich file extensions Capable recognises as a diagram, per language, and which extension an export produces.](https://help.gocapable.com/diagrams/file-types-and-extensions.html)[Rendering limitsWhich languages draw in the browser, what anonymous readers see, size caps, and which exports are unsupported.](https://help.gocapable.com/diagrams/rendering-limits.html)

---

## Related

[GuidesHow to actually use the editors.](https://help.gocapable.com/diagrams/guides.html)

[ExamplesWorking diagrams you can copy.](https://help.gocapable.com/diagrams/examples.html)

[TroubleshootingWhen the answer is not in the reference.](https://help.gocapable.com/diagrams/troubleshooting.html)

---

_Look it up, then get back to work._