diff --git a/ext/opentelemetry-ext-dbapi/README.rst b/ext/opentelemetry-ext-dbapi/README.rst
index b0bdbdd3126..4140e23f981 100644
--- a/ext/opentelemetry-ext-dbapi/README.rst
+++ b/ext/opentelemetry-ext-dbapi/README.rst
@@ -1,5 +1,5 @@
 OpenTelemetry Database API integration
-=================================
+======================================
 
 The trace integration with Database API supports libraries following the specification.
 
@@ -8,7 +8,7 @@ The trace integration with Database API supports libraries following the specifi
 Usage
 -----
 
-.. code:: python
+.. code-block:: python
 
     import mysql.connector
     from opentelemetry.trace import tracer_source
diff --git a/ext/opentelemetry-ext-mysql/README.rst b/ext/opentelemetry-ext-mysql/README.rst
index e899a980fc8..60190f0530a 100644
--- a/ext/opentelemetry-ext-mysql/README.rst
+++ b/ext/opentelemetry-ext-mysql/README.rst
@@ -1,10 +1,10 @@
 OpenTelemetry MySQL integration
-=================================
+===============================
 
 The integration with MySQL supports the `mysql-connector`_ library and is specified
 to ``trace_integration`` using ``'MySQL'``.
 
-.. mysql-connector: https://pypi.org/project/mysql-connector/
+.. _mysql-connector: https://pypi.org/project/mysql-connector/
 
 Usage
 -----
diff --git a/ext/opentelemetry-ext-prometheus/README.rst b/ext/opentelemetry-ext-prometheus/README.rst
index 2d968d6a7c8..e70332556e2 100644
--- a/ext/opentelemetry-ext-prometheus/README.rst
+++ b/ext/opentelemetry-ext-prometheus/README.rst
@@ -1,5 +1,5 @@
 OpenTelemetry Prometheus Exporter
-=============================
+=================================
 
 |pypi|
 
diff --git a/ext/opentelemetry-ext-psycopg2/README.rst b/ext/opentelemetry-ext-psycopg2/README.rst
index 9399c80facc..34be26784bc 100644
--- a/ext/opentelemetry-ext-psycopg2/README.rst
+++ b/ext/opentelemetry-ext-psycopg2/README.rst
@@ -4,12 +4,13 @@ OpenTelemetry Psycopg integration
 The integration with PostgreSQL supports the `Psycopg`_ library and is specified
 to ``trace_integration`` using ``'PostgreSQL'``.
 
-.. Psycopg: http://initd.org/psycopg/
+.. _Psycopg: http://initd.org/psycopg/
 
 Usage
 -----
 
-.. code:: python
+.. code-block:: python
+
     import psycopg2
     from opentelemetry import trace
     from opentelemetry.sdk.trace import TracerSource
@@ -26,4 +27,4 @@ Usage
 
 References
 ----------
-* `OpenTelemetry Project <https://opentelemetry.io/>`_
\ No newline at end of file
+* `OpenTelemetry Project <https://opentelemetry.io/>`_