replacing pictures with html/markdown syntax

external/contribute/markdown/markdown.md

@@ -32,18 +32,8 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
 
     <img src="img/visual-code_img_10.png">
 
-- **tips to write in markdown:**
 
-    <img src="img/visual-code_img_18.png">
-
-**insert pictures:**
-    <img src="img/visual-code_img_19.png" width="1000">
-
-**create a table**
-    <img src="img/visual-code_img_20.png">
-
-
-## Syntax
+## Tips to write in markdown:
 <table>
   <thead>
   <tr>
@@ -88,11 +78,12 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
         2. Second item
         3. Third item
         &nbsp;&nbsp;&nbsp;&nbsp;1. Indented item
-        &nbsp;&nbsp;&nbsp;&nbsp;2. Indented item
+        &nbsp;&nbsp;&nbsp;&nbsp;1. Indented item
         4. Fourth item
       </pre>
     </td>
     <td>
+    Use numbers for ordered lists:
     <ol>
       <li>First item</li>
       <li>Second item</li>
@@ -109,16 +100,17 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
   <tr>
     <td>
       <pre>
-      For unordered lists
-        * First item
-        * Second item
+      For unordered lists use asterisk, minus or plus
+        - First item
+        - Second item
         * Third item
         &nbsp;&nbsp;&nbsp;&nbsp;* Indented item
-        &nbsp;&nbsp;&nbsp;&nbsp;* Indented item
+        &nbsp;&nbsp;&nbsp;&nbsp;+ Indented item
         * Fourth item
       </pre>
     </td>
     <td>
+    For unordered lists use asterisk, minus or plus
     <ul>
       <li>First item</li>
       <li>Second item</li>
@@ -143,12 +135,23 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
   </tr>
   <tr>
     <td>
+     
       <pre>
-      Include local pictures: ![My awesome picture](img/r3_logo.png)
+       Include local pictures using markdown:
+
+        ![My awesome picture](img/r3_logo.png)
+      </pre><br>
+      <pre>
+      Or use HTML tag allowing you to alter the image properties (e.g. size):
+
+        &lt;img src="img/r3_logo.png" width="40"&gt
       </pre>
     </td>
     <td>
-      Include local pictures: <img src="img/img.png">
+      Include local pictures using markdown: <br>
+      <img src="img/r3_logo.png"> <br>
+      Or use HTML tag allowing you to alter the image properties (e.g. size):<br>
+      <img src="img/r3_logo.png" width="40">
     </td>
   </tr>
   <tr>
@@ -156,21 +159,88 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
      <pre>
       Include code blocks!
       ```
-      def myAwesomeFunction(x) 
-        x+1;
-      myAwesomeFunction(2);
+      def myAwesomeFunction(x):
+        x+1
+      myAwesomeFunction(2)
       ```
       </pre>
     </td>
     <td>
     Include code blocks! <br>
       <code>
-      def myAwesomeFunction(x):
-        x+1
+      def myAwesomeFunction(x):<br>
+        x+1<br>
       myAwesomeFunction(2)
       </code>
     </td>
   </tr>
+  <tr>
+    <td>
+      <pre>
+      Create table:
+       |   Tables   |   Are  | Cool  |
+       |------------|:------:|:-----:|
+       | value one  | blue   | $1024 |
+       | value two  | red    | $256  |
+       | value three| green  | $128  |
+       </pre>
+    </td>
+    <td>
+      Create table:
+      <div>
+        <table>
+          <thead>
+            <tr>
+              <th>
+              Tables
+              </th>
+              <th>
+              Are
+              </th>
+              <th>
+              Cool
+              </th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td>
+              value one
+              </td>
+              <td>
+              blue
+              </td>
+              <td>
+              $1024
+              </td>
+            </tr>
+            <tr>
+              <td>
+              value two
+              </td>
+              <td>
+              red
+              </td>
+              <td>
+              $256
+              </td>
+            </tr>
+            <tr>
+              <td>
+              value tree
+              </td>
+              <td>
+              green
+              </td>
+              <td>
+              $128
+              </td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </td>
+  </tr>
   </tbody>
 </table>