What is Markdown and why is it important?

Markdown is a form of content editing that is used by many serious content producers. It is often preferred over rich text editors as it focuses users on the content - rather than its formatting. It provides basic 'markup' - capability to describe the document. Things like what are headings, what is bold, links - even images and tables.

However, it limits your ability to change layouts and styling. We often want you to leave the formatting and styling up to us - and instead focus on the content itself.

This helps to ensure the website is consistent in its styling, spacing and layout. It makes the website look professional and tidy.

It also allows us to control the layout when it comes to displaying this content over a myriad of different devices, with different screen sizes. If you dictate the layout in a rich text editor, this may look good on your screen, but probably won't on lots of other devices. This is a critical part of having a professional modern website.

Markdown is simple to learn - it uses basic symbols to indicate what lines are headings, dashes or numbers for lists and so on.
Click the ? and click on comprehensive help document to check the Help document
Example (Image): Put the codes below under the Markdown editor and click on the Preview tab to see the result.

Inline-style: ![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 1")

Reference-style: ![alt text][logo]

[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 2"

Alternatively, you can use the image icon to add the image you have uploaded to your file manager.

Markdown, Rich Text toggle

Where ever there is a Markdown editor, for pages or for Content collections Components etc. you can change the editor to  Richtext(RTE) using the tabs on top.

When you toggle from Markdown to RTE it will convert the text

But if you choose to toggle from RTE to Markdown, it will revert to the last Markdown version
If there is no previous Markdown version, it will be a blank canvas
There is an alert message when you toggle from RTE to Markdown
If you click OK on the alert, you can refresh the page and it will go back to the RTE version without losing the information