Merge pull request #958 from valberg/patch-1

Fix rst remnants

Author: RonnyPfannschmidt

docs/usage.md

@@ -35,13 +35,12 @@ version_file = "pkg/_version.py"
 Where ``pkg`` is the name of your package.
 
 
-.. code-block:: shell
-
-    $ python -m setuptools_scm
-
-    # To explore other options, try:
-    $ python -m setuptools_scm --help
+```commandline
+$ python -m setuptools_scm
 
+# To explore other options, try:
+$ python -m setuptools_scm --help
+```
 
 ## as cli tool
 
@@ -103,9 +102,9 @@ version = get_version(root='..', relative_to=__file__)
 ### version at runtime
 
 If you have opted not to hardcode the version number inside the package,
-you can retrieve it at runtime from PEP-0566_ metadata using
+you can retrieve it at runtime from [PEP-0566](https://www.python.org/dev/peps/pep-0566/) metadata using
 ``importlib.metadata`` from the standard library (added in Python 3.8)
-or the `importlib_metadata`_ backport:
+or the [`importlib_metadata`](https://pypi.org/project/importlib-metadata/) backport:
 
 ```python title="package_name/__init__.py"
 from importlib.metadata import version, PackageNotFoundError
@@ -117,9 +116,6 @@ except PackageNotFoundError:
     pass
 ```
 
-.. _PEP-0566: https://www.python.org/dev/peps/pep-0566/
-.. _importlib_metadata: https://pypi.org/project/importlib-metadata/
-
 
 ### Usage from Sphinx