docs: server-conf: Reference markdown conf doc
@@ -385,12 +385,13 @@ Markup
Customize markup and sanitized HTML. Currently, only Markdown (via Misaka) is
supported, but new languages are relatively easy to add.
+For a more detailed explanation, see :doc:`/docs/reference/markdown-config`.
.. code-block:: ini
[markup]
options = strikethrough, superscript, autolink, fenced-code
- flags = skip-html, escape, hard-wrap
+ flags =
allowed-elements =
allowed-attributes =
@@ -399,12 +400,12 @@ options
extension options can be used there, separated by comma, either by their
name (``fenced-code``) or as ``EXT_FENCED_CODE``.
- The `flask-misaka docs <https://flask-misaka.readthedocs.io/en/latest/#options>`_
- have a good explanation of what each extension options does.
-
Note: Use e.g. ``fenced-code`` (with a ``-`` dash) instead of
``fenced_code`` (underline) to refer to extension names.
+ For a more detailed explanation, see
+ :ref:`Markdown Configuration: Extensions <available-markdown-options>`
+
Default: ``strikethrough, superscript, autolink, fenced-code``
flags
@@ -413,6 +414,8 @@ flags
can be used here, separated by comma, either by their name (``hard-wrap``)
or as e.g. ``HTML_HARD_WRAP``.
+ For a more detailed explanation, see :doc:`/docs/reference/markdown-config`.
+
Default: (empty)
.. versionadded:: 0.12.4
@@ -425,6 +428,8 @@ allowed-elements
``ol``, ``p``, ``pre``, ``strong``, ``table``, ``tbody``, ``td``, ``th``,
``thead`` and ``ul`` are allowed.
+ For a more detailed explanation, see :doc:`/docs/reference/markdown-config`.
+
.. warning::
This option (together with ``allowed-attributes``) is frequently
@@ -444,6 +449,8 @@ allowed-attributes
By default, only ``align`` and ``href`` are allowed (same caveats as for
``allowed-elements`` above apply)
+ For a more detailed explanation, see :doc:`/docs/reference/markdown-config`.
+
Default: (empty)
.. note:: To allow images in comments, you need to add
