diff --git a/plugins/inputs/httpjson/README.md b/plugins/inputs/httpjson/README.md
index 19fe01445..3f7efb10a 100644
--- a/plugins/inputs/httpjson/README.md
+++ b/plugins/inputs/httpjson/README.md
@@ -1,8 +1,8 @@
 # HTTP JSON Input Plugin
 
-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.
+### DEPRECATED in Telegraf v1.6: Use [HTTP input plugin](../http) as replacement.
 
-Deprecated (1.6): use the [http](../http) input.
+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.
 
 ### Configuration:
 
diff --git a/plugins/inputs/jolokia/README.md b/plugins/inputs/jolokia/README.md
index 96ee48701..9f2a658f1 100644
--- a/plugins/inputs/jolokia/README.md
+++ b/plugins/inputs/jolokia/README.md
@@ -1,6 +1,6 @@
 # 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](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/jolokia2) plugin.
 
 #### Configuration
 
diff --git a/plugins/inputs/kafka_consumer_legacy/README.md b/plugins/inputs/kafka_consumer_legacy/README.md
index 2f0c219ea..86ccaa4c1 100644
--- a/plugins/inputs/kafka_consumer_legacy/README.md
+++ b/plugins/inputs/kafka_consumer_legacy/README.md
@@ -1,5 +1,7 @@
 # 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).
+
 The [Kafka](http://kafka.apache.org/) consumer plugin polls a specified Kafka
 topic and adds messages to InfluxDB. The plugin assumes messages follow the
 line protocol. [Consumer Group](http://godoc.org/github.com/wvanbergen/kafka/consumergroup)
diff --git a/plugins/inputs/logparser/README.md b/plugins/inputs/logparser/README.md
index 0abdba2c9..8cc513e98 100644
--- a/plugins/inputs/logparser/README.md
+++ b/plugins/inputs/logparser/README.md
@@ -1,11 +1,11 @@
 # Logparser Input Plugin
 
+### Deprecated in Telegraf 1.15: Please use the [tail][] plugin along with the [`grok` data format][grok parser].
+
 The `logparser` plugin streams and parses the given logfiles. Currently it
 has the capability of parsing "grok" patterns from logfiles, which also supports
 regex patterns.
 
-**Deprecated in Telegraf 1.15**: Please use the [tail][] plugin along with the [`grok` data format][grok parser].
-
 The `tail` plugin now provides all the functionality of the `logparser` plugin.
 Most options can be translated directly to the `tail` plugin:
 - For options in the `[inputs.logparser.grok]` section, the equivalent option
diff --git a/plugins/inputs/snmp_legacy/README.md b/plugins/inputs/snmp_legacy/README.md
index 06bebbcad..8e639900f 100644
--- a/plugins/inputs/snmp_legacy/README.md
+++ b/plugins/inputs/snmp_legacy/README.md
@@ -1,5 +1,7 @@
 # SNMP Legacy Input Plugin
 
+### Deprecated in version 1.0. Use [SNMP input plugin][].
+
 The SNMP input plugin gathers metrics from SNMP agents
 
 ### Configuration:
@@ -547,3 +549,5 @@ ifHCOutOctets,host=127.0.0.1,instance=enp5s0,unit=octets ifHCOutOctets=10565628i
 ifInDiscards,host=127.0.0.1,instance=enp5s0 ifInDiscards=0i 1456878706044510264
 ifHCInOctets,host=127.0.0.1,instance=enp5s0,unit=octets ifHCInOctets=76351777i 1456878706044531312
 ```
+
+[SNMP input plugin]: /plugins/inputs/snmp