This looks pretty good. The only thing I don't like is the coloring of tokens in the examples. It doesn't make them easier to read; it's just distracting.

This is partly due to the fact that Common Lisp rules are used for syntax highlighting - so the function, macro and special form names are highlighted somewhat randomly.

You could change:

  ```lisp
  foo
  ```

To

  ```
  foo
  ```

It would probably look better with no highlighting. The original arc tutorial was just a plain text file.

EDIT: Submitted a PR https://github.com/alephyud/bel/pull/5

You can see what it looks like here: https://github.com/shawwn/bel/blob/085b39f5b8ee9e50b9776972b...

Bel announcement and discussion: https://news.ycombinator.com/item?id=21231208

How can I use Bel?