diff --git a/array.c b/array.c
index 165e9a80e8..defcc868df 100644
--- a/array.c
+++ b/array.c
@@ -7845,7 +7845,7 @@ rb_ary_deconstruct(VALUE ary)
  *
  *  You can create an \Array object explicitly with:
  *
- *  - An {array literal}[doc/syntax/literals_rdoc.html#label-Array+Literals].
+ *  - An {array literal}[rdoc-ref:syntax/literals.rdoc@Array+Literals].
  *
  *  You can convert certain objects to Arrays with:
  *
diff --git a/complex.c b/complex.c
index 658e41359a..92f4e812d6 100644
--- a/complex.c
+++ b/complex.c
@@ -2269,7 +2269,7 @@ float_arg(VALUE self)
  *
  * You can create a \Complex object explicitly with:
  *
- * - A {complex literal}[doc/syntax/literals_rdoc.html#label-Complex+Literals].
+ * - A {complex literal}[rdoc-ref:syntax/literals.rdoc@Complex+Literals].
  *
  * You can convert certain objects to \Complex objects with:
  *
diff --git a/hash.c b/hash.c
index 78e0b50a26..b5a711f2a9 100644
--- a/hash.c
+++ b/hash.c
@@ -6746,7 +6746,7 @@ static const rb_data_type_t env_data_type = {
  *
  *  You can create a \Hash object explicitly with:
  *
- *  - A {hash literal}[doc/syntax/literals_rdoc.html#label-Hash+Literals].
+ *  - A {hash literal}[rdoc-ref:syntax/literals.rdoc@Hash+Literals].
  *
  *  You can convert certain objects to Hashes with:
  *
diff --git a/numeric.c b/numeric.c
index 216b33920c..b2f41a3f86 100644
--- a/numeric.c
+++ b/numeric.c
@@ -948,7 +948,7 @@ num_negative_p(VALUE num)
  *
  *  You can create a \Float object explicitly with:
  *
- *  - A {floating-point literal}[doc/syntax/literals_rdoc.html#label-Float+Literals].
+ *  - A {floating-point literal}[rdoc-ref:syntax/literals.rdoc@Float+Literals].
  *
  *  You can convert certain objects to Floats with:
  *
@@ -3482,7 +3482,7 @@ rb_num2ull(VALUE val)
  *
  * You can create an \Integer object explicitly with:
  *
- * - An {integer literal}[doc/syntax/literals_rdoc.html#label-Integer+Literals].
+ * - An {integer literal}[rdoc-ref:syntax/literals.rdoc@Integer+Literals].
  *
  * You can convert certain objects to Integers with:
  *
diff --git a/proc.c b/proc.c
index 6a04a6a958..aa6f31f294 100644
--- a/proc.c
+++ b/proc.c
@@ -3972,7 +3972,7 @@ proc_ruby2_keywords(VALUE procval)
  *
  *      lambda1 = lambda {|x| x**2 }
  *
- * * Use the {Lambda proc literal}[doc/syntax/literals_rdoc.html#label-Lambda+Proc+Literals] syntax
+ * * Use the {Lambda proc literal}[rdoc-ref:syntax/literals.rdoc@Lambda+Proc+Literals] syntax
  *   (also constructs a proc with lambda semantics):
  *
  *      lambda2 = ->(x) { x**2 }
diff --git a/range.c b/range.c
index 0acbc36045..7cdb96b228 100644
--- a/range.c
+++ b/range.c
@@ -2052,7 +2052,7 @@ range_count(int argc, VALUE *argv, VALUE range)
  *
  * You can create an \Range object explicitly with:
  *
- * - A {range literal}[doc/syntax/literals_rdoc.html#label-Range+Literals]:
+ * - A {range literal}[rdoc-ref:syntax/literals.rdoc@Range+Literals]:
  *
  *     # Ranges that use '..' to include the given end value.
  *     (1..4).to_a      # => [1, 2, 3, 4]
diff --git a/rational.c b/rational.c
index 6d013c57c9..16f45173c2 100644
--- a/rational.c
+++ b/rational.c
@@ -2717,7 +2717,7 @@ nurat_s_convert(int argc, VALUE *argv, VALUE klass)
  *
  * You can create a \Rational object explicitly with:
  *
- * - A {rational literal}[doc/syntax/literals_rdoc.html#label-Rational+Literals].
+ * - A {rational literal}[rdoc-ref:syntax/literals.rdoc@Rational+Literals].
  *
  * You can convert certain objects to Rationals with:
  *
diff --git a/re.c b/re.c
index d37851a251..49b619ed9c 100644
--- a/re.c
+++ b/re.c
@@ -4081,7 +4081,7 @@ re_warn(const char *s)
  *
  *  You can create a \Regexp object explicitly with:
  *
- *  - A {regexp literal}[doc/syntax/literals_rdoc.html#label-Regexp+Literals].
+ *  - A {regexp literal}[rdoc-ref:syntax/literals.rdoc@Regexp+Literals].
  *
  *  :include: doc/regexp.rdoc
  */
diff --git a/string.c b/string.c
index e52812af16..aafed18549 100644
--- a/string.c
+++ b/string.c
@@ -11234,7 +11234,7 @@ rb_str_unicode_normalized_p(int argc, VALUE *argv, VALUE str)
  *
  * You can create a \Symbol object explicitly with:
  *
- * - A {symbol literal}[doc/syntax/literals_rdoc.html#label-Symbol+Literals].
+ * - A {symbol literal}[rdoc-ref:syntax/literals.rdoc@Symbol+Literals].
  *
  * The same Symbol object will be
  * created for a given name or string for the duration of a program's
@@ -11960,8 +11960,8 @@ rb_enc_interned_str_cstr(const char *ptr, rb_encoding *enc)
  *
  *  You can create a \String object explicitly with:
  *
- *  - A {string literal}[doc/syntax/literals_rdoc.html#label-String+Literals].
- *  - A {heredoc literal}[doc/syntax/literals_rdoc.html#label-Here+Document+Literals].
+ *  - A {string literal}[rdoc-ref:syntax/literals.rdoc@String+Literals].
+ *  - A {heredoc literal}[rdoc-ref:syntax/literals.rdoc@Here+Document+Literals].
  *
  *  You can convert certain objects to Strings with:
  *
@@ -12051,7 +12051,7 @@ rb_enc_interned_str_cstr(const char *ptr, rb_encoding *enc)
  *  Note that <tt>\\\\</tt> is interpreted as an escape, i.e., a single backslash.
  *
  *  Note also that a string literal consumes backslashes.
- *  See {String Literals}[doc/syntax/literals_rdoc.html#label-String+Literals] for details about string literals.
+ *  See {String Literals}[rdoc-ref:syntax/literals.rdoc@String+Literals] for details about string literals.
  *
  *  A back-reference is typically preceded by an additional backslash.
  *  For example, if you want to write a back-reference <tt>\&</tt> in