Update doc

Author: chdemko

README.md

@@ -27,20 +27,28 @@ Instructions
 
 Install *pandoc-beamer-block* using the bash command
 
-    pip install pandoc-beamer-block
+~~~shell
+$ pip install pandoc-beamer-block
+~~~
 
 To upgrade to the most recent release, use
 
-    pip install --upgrade pandoc-beamer-block
+~~~shell
+$ pip install --upgrade pandoc-beamer-block
+~~~
 
 To upgrade to the current code, use
 
-    pip install --upgrade --force git+https://github.com/chdemko/pandoc-beamer-block
+~~~shell
+$ pip install --upgrade --force git+https://github.com/chdemko/pandoc-beamer-block
+~~~
 
 `pip` is a script that downloads and installs modules from the Python Package Index, [PyPI].  It should come installed with your python distribution. If you are running linux, `pip` may be bundled separately. On a Debian-based system (including Ubuntu), you can install it as root using
 
-    apt-get update
-    apt-get install python3-pip
+~~~shell
+$ sudo apt-get update
+$ sudo apt-get install python3-pip
+~~~
 
 [python]: https://www.python.org
 [on Windows]: https://www.python.org/downloads/windows

docs/usage.md

@@ -14,22 +14,22 @@ decorate `div` elements by blocks
 The metadata block add information using the `pandoc-beamer-block` entry
 by a list of definitions:
 
-``` yaml
+~~~yaml
 pandoc-beamer-block:
   - classes: [info]
   - classes: [alert]
     type: alert
-```
+~~~
 
 The metadata block above is used to add a `block` environment around
 `div`s which have `info` class and a `alertblock` environment to `div`s
 that have only a `alert` class.
 
 Each entry of `pandoc-beamer-block` is a YAML dictionary containing:
 
-- `classes`: the set of classes of the `div`s to which the
+* `classes`: the set of classes of the `div`s to which the
   transformation will be applied. This parameter is mandatory.
-- `type`: the block type (either `alert`, `example` or `info`)
+* `type`: the block type (either `alert`, `example` or `info`)
 
 ## Example
 
@@ -38,11 +38,11 @@ Demonstration: Using
 as input gives output file in
 [pandoc-beamer-block-sample.pdf](https://raw.githubusercontent.com/chdemko/pandoc-beamer-block/develop/docs/images/pandoc-beamer-block-sample.pdf).
 
-``` console
+~~~shell
 $ pandoc \
     -t beamer \
     -V theme:Warsaw \
     --filter pandoc-beamer-block \
     -o docs/images/pandoc-beamer-block-sample.pdf \
     docs/images/pandoc-beamer-block-sample.txt
-```
+~~~