From fc8da143f0f67d22a334bf723ed27981b16c40a6 Mon Sep 17 00:00:00 2001
From: Maksim Sukharev <antreesy.web@gmail.com>
Date: Tue, 12 Dec 2023 12:02:36 +0100
Subject: [PATCH] feat(user_manual): add markdown usage (Talk 17.1+)

Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>
---
 user_manual/talk/talk_basics.rst | 53 ++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/user_manual/talk/talk_basics.rst b/user_manual/talk/talk_basics.rst
index c2c628c65..eff5e82fe 100644
--- a/user_manual/talk/talk_basics.rst
+++ b/user_manual/talk/talk_basics.rst
@@ -94,6 +94,59 @@ You can add emoji using the picker on the left of the text input field.
 .. image:: images/emoji-picker.png
    :width: 450px
 
+Using Markdown
+---------------
+
+You can enhance your messages with a markdown syntax support. See list for usage:
+
+**Headings and dividers**
+
+.. code-block:: none
+
+  # Heading 1
+  ## Heading 2
+  ### Heading 3
+  #### Heading 4
+  ##### Heading 5
+  ###### Heading 6
+
+  Heading
+  ===
+  Normal text
+  ***
+  Normal text
+
+**Inline decorations**
+
+.. code-block:: none
+
+  **bold text** __bold text__
+  *italicized text* _italicized text_
+  `inline code` ``inline code``
+  ```
+  .code-block {
+    display: pre;
+  }
+  ```
+
+**Lists**
+
+.. code-block:: none
+
+  1. Ordered list
+  2. Ordered list
+
+  * Unordered list
+  - Unordered list
+  + Unordered list
+
+**Quotes**
+
+.. code-block:: none
+
+  > blockquote
+  second line of blockquote
+
 Replying to messages and more
 -----------------------------