# Frequently asked questions about Markdown in Confluence Short answers to the questions we hear most, each with a link to the page that explains it properly. --- ## Writing and importing ### Can I write Markdown directly in Confluence? Yes. Insert the Markdown macro, choose Markdown from scratch and write in the edit, split and preview editor. See [Write Markdown in Confluence](https://help.gocapable.com/markdown/write-markdown-in-confluence.html). ### Can I import a .md file? Yes. Use **Upload file** in the editor for an editable copy, or **Markdown from file** to render an attachment. See [Import a Markdown file into Confluence](https://help.gocapable.com/markdown/import-a-markdown-file-into-confluence.html). ### Can I show a README from a private repository? No. Capable fetches the file without your sign-in, so it must be publicly reachable. See [Show a GitHub README in Confluence](https://help.gocapable.com/markdown/show-a-github-readme-in-confluence.html). ### Which diagram languages can I use? 27, including Mermaid, PlantUML and BPMN, written as fenced code blocks. See [Diagrams from fenced code blocks](https://help.gocapable.com/markdown/diagrams-from-fenced-code-blocks.html). ### Why can I not upload an image while editing a library template? Uploaded images become attachments of the page that shows the document, and a library template has no page. Upload images while editing a document on a real page, or pick them from the library. See [Cannot upload an image while editing a library template](https://help.gocapable.com/markdown/cannot-upload-an-image-while-editing-a-library-template-cannot-upload-images-to-a-template.html). --- ## Templates ### If I edit a template, do pages that use it update? Pages that use the Markdown reference macro do. Pages where the template was inserted as an ordinary Markdown document keep their own copy. See [Markdown reference](https://help.gocapable.com/markdown/markdown-reference.html). ### Can I find templates from the page byline? In the Capable suite, yes. The search in the **Capable** byline item finds your space and global templates and the built-in starter templates, and opens the editor ready to insert. See [Insert a Markdown template from the byline](https://help.gocapable.com/markdown/insert-a-markdown-template-from-the-byline.html). ### Why does a starter template have no version history? The 17 starter templates ship with the app and never change, so there is no history to show. Remix one into your space if you want your own versions. See [Version history](https://help.gocapable.com/markdown/version-history.html). --- ## Readers, exports and admin ### Why does a logged-out reader see Sign in to view this markdown? The document is loaded for each reader, and Confluence does not let the app do that for someone it cannot identify. Publish the page with Capable Sites for anonymous audiences. See [the troubleshooting page](https://help.gocapable.com/markdown/logged-out-reader-on-a-public-page-sees-sign-in-to-view-this-markdown-instead-of-the-document.html). ### Why does an exported Word or PDF show raw Markdown? Confluence's export includes the Markdown document as a code block of its source. For a rendered copy, publish it to a Capable Site. See [Exported Word or PDF shows raw markdown source](https://help.gocapable.com/markdown/exported-word-or-pdf-shows-raw-markdown-source-in-a-code-block.html). ### Can I hide Markdown from my site or a space? Yes. An administrator can hide it in Capable's global settings, and a space administrator can hide it in space settings. Macros already on pages keep rendering. See [Markdown settings](https://help.gocapable.com/markdown/markdown-settings.html). --- ## Related ### [Writing Markdown in Confluence](https://help.gocapable.com/markdown/writing-markdown-in-confluence.html) Getting Markdown onto pages. ### [Sharing Markdown templates in Confluence](https://help.gocapable.com/markdown/sharing-markdown-templates-in-confluence.html) Templates people reuse. ### [Troubleshooting](https://help.gocapable.com/markdown/troubleshooting.html) 27 symptoms, grouped by where they bite. --- _Not here? The troubleshooting pages go deeper._