summaryrefslogtreecommitdiff
path: root/design-documents
diff options
context:
space:
mode:
Diffstat (limited to 'design-documents')
-rw-r--r--design-documents/003-tos-rendering.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/design-documents/003-tos-rendering.rst b/design-documents/003-tos-rendering.rst
index 5f6d8157..52d293c3 100644
--- a/design-documents/003-tos-rendering.rst
+++ b/design-documents/003-tos-rendering.rst
@@ -42,6 +42,27 @@ document" for generating the corresponding legal agreement document in other
formats. However, service providers can also provide custom versions with more
appropriate styling, like a logo in the header of a printable PDF document.
+Markdown Conventions
+--------------------
+
+The ``text/markdown`` document **should** follow
+the `commonmark spec <https://spec.commonmark.org/0.28/>`__.
+Main headlines (level 1) and their following content (until the next main headline)
+will be shown as expandable sections in wallets.
+
+The document **must** begin with a main headline:
+
+.. code-block::
+
+ # First Headline
+
+or
+
+.. code-block::
+
+ First Headline
+ ==============
+
Alternatives
============