default_role = literal

for markdown-style `literal` to do what people expect in rst

docs/conf.py

@@ -89,7 +89,7 @@
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
-#default_role = None
+default_role = 'literal'
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
 #add_function_parentheses = True