Markdown is a way of writing, never a way of saving. What you type in Markdown becomes blocks at once; the article is saved as HTML.
Typing shortcuts
At the start of a paragraph, followed by a space:
| Type | You get |
|---|---|
# or ## | Heading 2 |
### to ###### | Heading 3 to 6 |
-, * or + | Bulleted list |
1. or 1) | Numbered list |
> | Quote |
``` | Code block |
Inside a sentence, as soon as the closing mark is typed:
| Type | You get |
|---|---|
**words** | bold |
*words* or _words_ | italic |
`words` | code |
A single # gives level 2: the article title is already level 1.
Pasting Markdown
Paste a Markdown text (from Claude, from GitHub, from a file): Markus recognises it and turns it into blocks. Headings, lists, links, images, tables, code, quotes, footnotes, task lists: all common Markdown is understood.
HTML written in the Markdown comes out as text: a pasted <script> never becomes a tag. Only a few harmless text tags go through (br, kbd, sup, sub, mark, abbr...).
A <!-- readmore --> line becomes Joomla's Read more.
Pasting from Word or a web page
The text is cleaned: Word's styles go, lists are rebuilt, headings stay headings. Images do not travel through the clipboard: Markus says so, and you insert them with the Image block.
Opening and saving a .md file
- Open a .md file loads the file into the article. You can also drop it on the article.
- Save as .md downloads the article as Markdown, named after its title.
The Markdown view
Write in Markdown (Ctrl+Shift+M) shows the whole article in Markdown. Edit it, then go back to the blocks with the same shortcut.
Markdown cannot write everything: a style, a class, a page break, an HTML comment. Before switching to Markdown, Markus lists what would be lost, and you choose: Switch to Markdown anyway, or stay in blocks.
The HTML source code
HTML source code (Ctrl+Shift+U) shows the article's HTML, highlighted by CodeMirror. The same shortcut brings you back to the blocks.
Up to date for Markus 1.0.088.