diff --git a/plugins/inputs/httpjson/README.md b/plugins/inputs/httpjson/README.md
index e001e5b07..8782e71e3 100644
--- a/plugins/inputs/httpjson/README.md
+++ b/plugins/inputs/httpjson/README.md
@@ -1,6 +1,6 @@
 # HTTP JSON Input Plugin
 
-**DEPRECATED in Telegraf v1.6: Use [HTTP input plugin](../http) as replacement**
+## DEPRECATED in Telegraf v1.6: Use [HTTP input plugin][] as replacement
 
 The httpjson plugin collects data from HTTP URLs which respond with JSON.  It flattens the JSON and finds all numeric values, treating them as floats.
 
@@ -134,3 +134,5 @@ If the service returns an array of objects, one metric is be created for each ob
 
 `httpjson,server=http://localhost:9999/stats/,service=service01 a=0.5,b_d=0.1,b_e=5,response_time=0.003`
 `httpjson,server=http://localhost:9999/stats/,service=service02 a=0.6,b_d=0.2,b_e=6,response_time=0.003`
+
+[HTTP input plugin]: /plugins/inputs/http
diff --git a/plugins/inputs/jolokia/README.md b/plugins/inputs/jolokia/README.md
index 0fdd25a94..3b152f8e0 100644
--- a/plugins/inputs/jolokia/README.md
+++ b/plugins/inputs/jolokia/README.md
@@ -1,8 +1,8 @@
 # Jolokia Input Plugin
 
-## Deprecated in version 1.5: Please use the [jolokia2](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/jolokia2) plugin
+## Deprecated in version 1.5: Please use the [jolokia2][] plugin
 
-### Configuration
+## Configuration
 
 ```toml
 # Read JMX metrics through Jolokia
@@ -61,14 +61,15 @@
     attribute = "LoadedClassCount,UnloadedClassCount,TotalLoadedClassCount"
 ```
 
-#### Description
+## Description
 
 The Jolokia plugin collects JVM metrics exposed as MBean's attributes through
 jolokia REST endpoint. All metrics are collected for each server configured.
-
-See: <https://jolokia.org/>
+See [official Jolokia website](https://jolokia.org/) for more information.
 
 ## Measurements
 
 Jolokia plugin produces one measure for each metric configured,
 adding Server's `jolokia_name`, `jolokia_host` and `jolokia_port` as tags.
+
+[jolokia2]: /plugins/inputs/jolokia2
diff --git a/plugins/inputs/kafka_consumer_legacy/README.md b/plugins/inputs/kafka_consumer_legacy/README.md
index 1faf4c230..59b176781 100644
--- a/plugins/inputs/kafka_consumer_legacy/README.md
+++ b/plugins/inputs/kafka_consumer_legacy/README.md
@@ -1,6 +1,6 @@
 # Kafka Consumer Legacy Input Plugin
 
-## Deprecated in version 1.4. Please use [Kafka Consumer input plugin](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/kafka_consumer)
+## Deprecated in version 1.4. Please use [Kafka Consumer input plugin][]
 
 The [Kafka](http://kafka.apache.org/) consumer plugin polls a specified Kafka
 topic and adds messages to InfluxDB. The plugin assumes messages follow the
@@ -43,3 +43,5 @@ from the same topic in parallel.
 
 Running integration tests requires running Zookeeper & Kafka. See Makefile
 for kafka container command.
+
+[Kafka Consumer input plugin]: /plugins/inputs/kafka_consumer