diff --git a/docs/rules/index.liquid b/docs/rules/index.liquid
index 53d683aa17..33a10ede0a 100644
--- a/docs/rules/index.liquid
+++ b/docs/rules/index.liquid
@@ -50,17 +50,22 @@ layout: doc
{{ rule.name }}
|
- {% if rule.replacedBy.size > 0 %}
-
- {% for replaced in rule.replacedBy %}
- {{ replaced }}
- {% endfor %}
- |
- {% else %}
-
- (no replacement)
- |
- {% endif %}
+
+ {% assign hasReplacement = false %}
+ {% if rule.replacedBy.size > 0 %}
+ {% for replaced in rule.replacedBy %}
+ {% comment %} Do not link to rule docs in 3rd party plugins. {% endcomment %}
+ {% assign ruleNameSegments = replaced | split: "/" %}
+ {% if ruleNameSegments.size == 1 %}
+ {{ replaced }}
+ {% assign hasReplacement = true %}
+ {% endif %}
+ {% endfor %}
+ {% endif %}
+ {% if hasReplacement == false %}
+ (no replacement)
+ {% endif %}
+ |
{% endfor %}