From cad179b23e07a9bba6fca283681c96ce7e150b0f Mon Sep 17 00:00:00 2001
From: Marc Beninca <rtfd@computing.land>
Date: Tue, 11 Dec 2018 15:44:56 +0100
Subject: [PATCH] rst: links, line break, comment

---
 .../documents/restructuredtext/syntax.rst     | 28 ++++++++++++++++---
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/in/public/documents/restructuredtext/syntax.rst b/in/public/documents/restructuredtext/syntax.rst
index 0877b8f..bb6bd27 100644
--- a/in/public/documents/restructuredtext/syntax.rst
+++ b/in/public/documents/restructuredtext/syntax.rst
@@ -27,6 +27,26 @@ Sections
   Paragraph
   """""""""
 
+Links
+=====
+
+Internal
+--------
+
+declaration
+^^^^^^^^^^^
+
+.. code:: restructuredtext
+
+ .. label_name:
+
+reference
+^^^^^^^^^
+
+.. code:: restructuredtext
+
+ :ref:`label_name`_
+
 ToSort
 ======
 
@@ -40,19 +60,19 @@ ToSort
 * **2 stars**
 * ``2 backquotes``
 
-After this comma,
+| After this comma,
 | output new line
+|
 
+.. image:: image.png
 
-.. comment
+.. this is a really useless comment
 
 ..
     multiline
 
     comment
 
-.. image:: image.png
-
 Indent 0
 
   Indent 1 which