# Everything else 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** | | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Typed a title on my markdown macro and nothing changed on the page | Two separate reasons. First, the title strip only renders when 'Show Border' is on. With the border off there is nowhere to show it. Second, the title you type is saved onto the stored docum | | Filled in 'Markdown description' in the macro config, was warned about unsaved changes, saved, and t | The save path never passes the description through, even though the underlying store accepts one. The unsaved-changes guard still counts a description edit as a change, so you are prompted t | | Logged-out reader on a public page sees 'Sign in to view this markdown' instead of the document | The document is loaded from an external URL. URL markdown is fetched through the Capable proxy, which needs a client token, and anonymous readers are never issued one. | | Diagram code blocks show as plain code instead of pictures for some readers | Rendering a fence needs a Capable client token, which logged-out readers do not have. This is a deliberate degrade, not an error. | | Images inside a markdown document show only alt text with a 'Sign in to view this image' tooltip | The image needs the Capable proxy and the reader has no token. Only relative Confluence paths, \*.atlassian.net / \*.atl-paas.net, the Capable CDN, images.unsplash.com and approved egress doma | | Image inside the document eventually turns into '\[Image load timed out: …\]' | The image did not load within 15 seconds. | | Wrote HTML in my markdown and it disappeared entirely | Raw HTML is never rendered. Both the editor preview and the viewer strip HTML and run a sanitiser, so anything outside the safe GitHub element and attribute set is silently dropped with no w | | LaTeX maths ($…$ or $$…$$) renders as literal dollar signs | There is no math or LaTeX plugin in the markdown pipeline. | | Mermaid diagram works in mermaid.js elsewhere but fails or looks different here | Diagrams are rendered server-side by Kroki, not by the browser mermaid library, so syntax that only newer mermaid.js supports can fail. Separately, mermaid C4 blocks are silently rewritten t | | We configured a self-hosted diagram renderer but markdown diagrams still go through Capable | The self-hosted renderer path is currently disabled by a hard kill switch. | | Big document renders inside a small scrolling box with a '⚠️ Large content detected' banner | The document is over 500,000 characters, so the macro switches to a fixed 1200px-high scroller and virtualised rendering. | | Editor is replaced by 'Invalid markdown provided' naming some other language | The renderer threw on the current text AND language detection guessed something other than markdown, HTML, Lua or unknown. A very code-heavy document can trip this. | | Saving a macro fails with 'Unable to save changes as the loaded markdown is not associated with the | The stored document belongs to a different page than the one you are editing. Typically after copying a page that carries the macro, before the copy is reconciled. | | Freshly inserted macro sits on a placeholder for a long time before showing content | The document exists but has not been indexed yet, so the macro retries every 15 seconds up to 10 times. About two and a half minutes. | --- ## In this section [Typed a title on my markdown macro and nothing changed on the pageI typed a title on my markdown macro and nothing changed on the page.](https://help.gocapable.com/markdown/typed-a-title-on-my-markdown-macro-and-nothing-changed-on-the-page.html)[Filled in 'Markdown description' in the macro config, was warned about unsaved changes, saved, and tI filled in 'Markdown description' in the macro config, was warned about unsaved changes, saved, and the description was gone.](https://help.gocapable.com/markdown/filled-in-markdown-description-in-the-macro-config-was-warned-about-unsaved-changes-saved-and-t.html)[Logged-out reader on a public page sees 'Sign in to view this markdown' instead of the documentA logged-out reader on a public page sees 'Sign in to view this markdown' instead of the document.](https://help.gocapable.com/markdown/logged-out-reader-on-a-public-page-sees-sign-in-to-view-this-markdown-instead-of-the-document.html)[Diagram code blocks show as plain code instead of pictures for some readersDiagram code blocks show as plain code instead of pictures for some readers.](https://help.gocapable.com/markdown/diagram-code-blocks-show-as-plain-code-instead-of-pictures-for-some-readers.html)[Images inside a markdown document show only alt text with a 'Sign in to view this image' tooltipImages inside a markdown document show only alt text with a 'Sign in to view this image' tooltip.](https://help.gocapable.com/markdown/images-inside-a-markdown-document-show-only-alt-text-with-a-sign-in-to-view-this-image-tooltip.html)[Image inside the document eventually turns into '\[Image load timed out: …\]'An image inside the document eventually turns into '\[Image load timed out: …\]'.](https://help.gocapable.com/markdown/image-inside-the-document-eventually-turns-into-image-load-timed-out.html)[Wrote HTML in my markdown and it disappeared entirelyI wrote HTML in my markdown and it disappeared entirely.](https://help.gocapable.com/markdown/wrote-html-in-my-markdown-and-it-disappeared-entirely.html)[LaTeX maths ($…$ or $$…$$) renders as literal dollar signsMy LaTeX maths ($…$ or $$…$$) renders as literal dollar signs.](https://help.gocapable.com/markdown/latex-maths-or-renders-as-literal-dollar-signs.html)[Mermaid diagram works in mermaid.js elsewhere but fails or looks different hereA mermaid diagram works in mermaid.js elsewhere but fails or looks different here.](https://help.gocapable.com/markdown/mermaid-diagram-works-in-mermaid-js-elsewhere-but-fails-or-looks-different-here.html)[We configured a self-hosted diagram renderer but markdown diagrams still go through CapableConfigured a self-hosted diagram renderer but markdown diagrams still go through Capable.](https://help.gocapable.com/markdown/we-configured-a-self-hosted-diagram-renderer-but-markdown-diagrams-still-go-through-capable.html)[Big document renders inside a small scrolling box with a '⚠️ Large content detected' bannerA big document renders inside a small scrolling box with a '⚠️ Large content detected' banner.](https://help.gocapable.com/markdown/big-document-renders-inside-a-small-scrolling-box-with-a-large-content-detected-banner.html)[Editor is replaced by 'Invalid markdown provided' naming some other languageThe editor is replaced by 'Invalid markdown provided' naming some other language.](https://help.gocapable.com/markdown/editor-is-replaced-by-invalid-markdown-provided-naming-some-other-language.html)[Saving a macro fails with 'Unable to save changes as the loaded markdown is not associated with theSaving a macro fails with 'Unable to save changes as the loaded markdown is not associated with the current page'.](https://help.gocapable.com/markdown/saving-a-macro-fails-with-unable-to-save-changes-as-the-loaded-markdown-is-not-associated-with-the.html)[Freshly inserted macro sits on a placeholder for a long time before showing contentA freshly inserted macro sits on a placeholder for a long time before showing content.](https://help.gocapable.com/markdown/freshly-inserted-macro-sits-on-a-placeholder-for-a-long-time-before-showing-content.html) --- ## Related [TroubleshootingEvery symptom.](https://help.gocapable.com/markdown/troubleshooting.html) [ReferenceLimits and gaps.](https://help.gocapable.com/markdown/reference.html) [How it worksThe behaviour.](https://help.gocapable.com/markdown/how-it-works.html) --- _Most of these are expected behaviour._