diff options
author | Isaac Virshup <ivirshup@gmail.com> | 2020-06-24 16:55:02 +1000 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-06-24 16:55:02 +1000 |
commit | 2df3917975e038bb2750227db19d1cc46bc3175e (patch) | |
tree | a1418933740c3c88fecf0766e1ae512a4d24ecc1 /rst.html.markdown | |
parent | ef0480286342219c7a592926660018534f5af12a (diff) |
[RST/en] Fix compile errors from link and escaping
There were two issues here:
* The non-inline link was used incorrectly, and should have a colon after the specifier.
* A compile error was generated from having a non-escaped `*`.
These can be verified by running `rst2html`:
```sh
$ rst2html.py ./restructuredtext.rst tmp.html
./restructuredtext.rst:24: (WARNING/2) Inline emphasis start-string without end-string.
./restructuredtext.rst:59: (WARNING/2) malformed hyperlink target.
```
After adding the colon, and adding the escape
```sh
$ rst2html.py ./restructuredtext.rst tmp.html
$
```
I've also added a sentence on escaping.
Diffstat (limited to 'rst.html.markdown')
-rw-r--r-- | rst.html.markdown | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/rst.html.markdown b/rst.html.markdown index 2423622e..bdc73c7a 100644 --- a/rst.html.markdown +++ b/rst.html.markdown @@ -49,9 +49,11 @@ Subtitles with dashes You can put text in *italic* or in **bold**, you can "mark" text as code with double backquote ``print()``. +Special characters can be escaped using a backslash, e.g. \\ or \*. + Lists are similar to Markdown, but a little more involved. -Remember to line up list symbols (like - or *) with the left edge of the previous text block, and remember to use blank lines to separate new lists from parent lists: +Remember to line up list symbols (like - or \*) with the left edge of the previous text block, and remember to use blank lines to separate new lists from parent lists: - First item - Second item @@ -86,7 +88,7 @@ There are multiple ways to make links: - By typing a full comprehensible URL : https://github.com/ (will be automatically converted to a link) - By making a more Markdown-like link: `Github <https://github.com/>`_ . -.. _Github https://github.com/ +.. _Github: https://github.com/ ``` |