Discourse uses Markdown as markup language. If you are familiar with GitHub, you’re good to go. If not, please follow this guide.
While you type something into the editor, you’ll recognize many things:
- live preview as you type on the right side
- if someone else is replying, a short notice on top of the editor
- you can navigate to a different page, and still reply to the “old” topic
- sessions are stored, which means that a draft text can be started on your Macbook and posted on your Ipad later.
You can use emojis to express your feelings. Start typing a colon
: and pick one from the popup editor.
If you need to quote a text, select it with the mouse and click the appearing "Quote button to insert it into your reply.
Use three backticks for multi-line code blocks, configuration snippets, log outputs, long texts, etc. - everything you know from Wordpress’s
<pre> tags or Confluence
``` 2018-02-01 all is good. 2018-02-02 uh, oh. 2018-02-03 kaboom. ```
# Heading 1
Relative URLs to static pages
You can use Markdown styled URLs with relative urls, e.g. /faq
as outlined in the [FAQ](/faq)
as outlined in the FAQ
* Major Task 1 * Task 1
- Major Task 1
- Task 1
Value | Host State | Service State ------|------------|-------------- 0 | Up | OK 1 | Up | Warning 2 | Down | Critical 3 | Down | Unknown
|Value||Host State||Service State|
If you want to mention another user, just type @ and select a possible name. Once your reply is saved, this user gets notified.
Images, screenshots and other graphics really help to understand a problem, or illustrate a procedure. This can be for example an exported Gliffy image, or just a printed screen.
You can add a new image with the upload icon. Either from your local disk, or from a web URL.
If you need to move the image around, just copy the entire
![31|385x233](upload://aklt7kcoGnKdMMXgCd3cxnch087.png) block to its desired location.
The embedded URL allows you to scale the image too. Discourse also downloads web images to cache them for faster access, or in case of broken images in the future.