Something is missing or looks wrong
Start from what you are seeing rather than from what you think is broken. Each page below names the symptom, explains why it happens, and says what to do about it.
Several of these are the product working as designed, which is worth knowing before anybody raises a ticket.
#At a glance
Symptom | Usually because |
|---|---|
Template I just created does not appear in the catalogue | After a create the app polls for the Confluence listing to include it, with a backoff of up to 8 seconds per attempt over eight attempts. |
Saving a template is refused with 'Failed to save markdown, missing title' or '...missing data' | Library templates require both a non-empty title and non-empty content. |
Versions are missing from Version history | Entries saved within 15 seconds of the previous shown one are collapsed so rapid auto-saves do not flood the list, and the list never shows more than the last 50 ('Limited to the last 50 ent |
Markdown macro is missing from an exported Word or PDF entirely | The reference macro contributes nothing to an export in either product. |
'From library' items are missing from the editor's Insert menu | They are contributed by the Images and Diagrams capabilities, which the standalone Markdown app does not ship. |
'Copy as macro' is missing for a template | Reference URLs are only produced for custom-content-backed documents. The bundled Examples comes with code, and URL- or attachment-sourced markdown has no referenceable id. |
Nothing on this site indexes and markdown counts stay empty | The product triggers that index markdown are filtered on the app being licensed, so on an unlicensed or evaluation site those events never fire. |
#In this section
#Related
Most of these are expected behaviour.
