diff --git a/packages/common/src/i18n/locale_data.ts b/packages/common/src/i18n/locale_data.ts
index 1d061dc6d8..d638d26bc3 100644
--- a/packages/common/src/i18n/locale_data.ts
+++ b/packages/common/src/i18n/locale_data.ts
@@ -13,7 +13,7 @@ export const LOCALE_DATA: {[localeId: string]: any} = {};
 
 /**
  * Register global data to be used internally by Angular. See the
- * {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale data.
+ * ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale data.
  *
  * @experimental i18n support is experimental.
  */
diff --git a/packages/common/src/i18n/locale_data_api.ts b/packages/common/src/i18n/locale_data_api.ts
index eb90cedacc..cbfd90f117 100644
--- a/packages/common/src/i18n/locale_data_api.ts
+++ b/packages/common/src/i18n/locale_data_api.ts
@@ -427,7 +427,7 @@ function checkFullData(data: any) {
  * You should fallback to AM/PM when there are no rules available.
  *
  * Note: this is only available if you load the full locale data.
- * See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale
+ * See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale
  * data.
  *
  * @experimental i18n support is experimental.
@@ -452,7 +452,7 @@ export function getLocaleExtraDayPeriodRules(locale: string): (Time | [Time, Tim
  * You should fallback to AM/PM when there are no day periods available.
  *
  * Note: this is only available if you load the full locale data.
- * See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale
+ * See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale
  * data.
  *
  * @experimental i18n support is experimental.
diff --git a/packages/common/src/pipes/date_pipe.ts b/packages/common/src/pipes/date_pipe.ts
index d70a002968..1c89c4df61 100644
--- a/packages/common/src/pipes/date_pipe.ts
+++ b/packages/common/src/pipes/date_pipe.ts
@@ -82,10 +82,10 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error';
  * WARNINGS:
  * - this pipe has only access to en-US locale data by default. If you want to localize the dates
  *   in another language, you will have to import data for other locales.
- *   See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import additional locale
+ *   See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import additional locale
  *   data.
  * - Fields suffixed with * are only available in the extra dataset.
- *   See the {@linkDocs guide/i18n#i18n-pipes "I18n guide"} to know how to import extra locale
+ *   See the ["I18n guide"](guide/i18n#i18n-pipes) to know how to import extra locale
  *   data.
  * - this pipe is marked as pure hence it will not be re-evaluated when the input is mutated.
  *   Instead users should treat the date as an immutable object and change the reference when the
diff --git a/packages/core/src/di/injectable.ts b/packages/core/src/di/injectable.ts
index 740878d3bf..581f1d0b6e 100644
--- a/packages/core/src/di/injectable.ts
+++ b/packages/core/src/di/injectable.ts
@@ -44,7 +44,7 @@ export interface InjectableDecorator {
    * @description
    * A marker metadata that marks a class as available to {@link Injector} for creation.
    *
-   * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+   * For more details, see the ["Dependency Injection Guide"(guide/dependency-injection).
    *
    * ### Example
    *
diff --git a/packages/core/src/di/injector.ts b/packages/core/src/di/injector.ts
index 0dedf6e2a4..a3d02e1018 100644
--- a/packages/core/src/di/injector.ts
+++ b/packages/core/src/di/injector.ts
@@ -53,7 +53,7 @@ export class NullInjector implements Injector {
  *
  * Concrete injectors implement this interface.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
diff --git a/packages/core/src/di/metadata.ts b/packages/core/src/di/metadata.ts
index 7ddb9cf9a3..32ec55cbfd 100644
--- a/packages/core/src/di/metadata.ts
+++ b/packages/core/src/di/metadata.ts
@@ -31,7 +31,7 @@ export interface InjectDecorator {
    * @description
    * A parameter decorator that specifies a dependency.
    *
-   * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+   * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
    *
    * ### Example
    *
@@ -85,7 +85,7 @@ export interface OptionalDecorator {
    * A parameter metadata that marks a dependency as optional.
    * {@link Injector} provides `null` if the dependency is not found.
    *
-   * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+   * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
    *
    * ### Example
    *
@@ -130,7 +130,7 @@ export interface SelfDecorator {
    * @description
    * Specifies that an {@link Injector} should retrieve a dependency only from itself.
    *
-   * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+   * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
    *
    * ### Example
    *
@@ -176,7 +176,7 @@ export interface SkipSelfDecorator {
    * @description
    * Specifies that the dependency resolution should start from the parent injector.
    *
-   * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+   * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
    *
    * ### Example
    *
@@ -222,7 +222,7 @@ export interface HostDecorator {
    * Specifies that an injector should retrieve a dependency from any injector until
    * reaching the host element of the current component.
    *
-   * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+   * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
    *
    * ### Example
    *
diff --git a/packages/core/src/di/provider.ts b/packages/core/src/di/provider.ts
index 447f7c2279..bb956dc81b 100644
--- a/packages/core/src/di/provider.ts
+++ b/packages/core/src/di/provider.ts
@@ -18,7 +18,7 @@ import {Type} from '../type';
  * @description
  * Configures the `Injector` to return a value for a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -42,7 +42,7 @@ export interface ValueSansProvider {
  * @description
  * Configures the `Injector` to return a value for a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -77,7 +77,7 @@ export interface ValueProvider extends ValueSansProvider {
  * @description
  * Configures the `Injector` to return an instance of `useClass` for a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -111,7 +111,7 @@ export interface StaticClassSansProvider {
  * @description
  * Configures the `Injector` to return an instance of `useClass` for a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -149,7 +149,7 @@ export interface StaticClassProvider extends StaticClassSansProvider {
  * @description
  * Configures the `Injector` to return an instance of a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * @experimental
  */
@@ -173,7 +173,7 @@ export interface ConstructorSansProvider {
  * @description
  * Configures the `Injector` to return an instance of a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -208,7 +208,7 @@ export interface ConstructorProvider extends ConstructorSansProvider {
  * @description
  * Configures the `Injector` to return a value of another `useExisting` token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -232,7 +232,7 @@ export interface ExistingSansProvider {
  * @description
  * Configures the `Injector` to return a value of another `useExisting` token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -269,7 +269,7 @@ export interface ExistingProvider extends ExistingSansProvider {
  * @description
  * Configures the `Injector` to return a value by invoking a `useFactory` function.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -302,7 +302,7 @@ export interface FactorySansProvider {
  * @description
  * Configures the `Injector` to return a value by invoking a `useFactory` function.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -337,7 +337,7 @@ export interface FactoryProvider extends FactorySansProvider {
  * @description
  * Describes how the `Injector` should be configured in a static way (Without reflection).
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  *
  */
@@ -360,7 +360,7 @@ export type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvi
  * Create an instance by invoking the `new` operator and supplying additional arguments.
  * This form is a short form of `TypeProvider`;
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -383,7 +383,7 @@ export interface TypeProvider extends Type<any> {}
  * @description
  * Configures the `Injector` to return a value by invoking a `useClass` function.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -410,7 +410,7 @@ export interface ClassSansProvider {
  * @description
  * Configures the `Injector` to return an instance of `useClass` for a token.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  * ### Example
  *
@@ -445,7 +445,7 @@ export interface ClassProvider extends ClassSansProvider {
  * @description
  * Describes how the `Injector` should be configured.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
  *
  */
diff --git a/packages/core/src/i18n/tokens.ts b/packages/core/src/i18n/tokens.ts
index 7bbec4939d..55786e6db2 100644
--- a/packages/core/src/i18n/tokens.ts
+++ b/packages/core/src/i18n/tokens.ts
@@ -13,7 +13,7 @@ import {InjectionToken} from '../di/injection_token';
  * It is used for i18n extraction, by i18n pipes (DatePipe, I18nPluralPipe, CurrencyPipe,
  * DecimalPipe and PercentPipe) and by ICU expressions.
  *
- * See the {@linkDocs guide/i18n#setting-up-locale i18n guide} for more information.
+ * See the [i18n guide](guide/i18n#setting-up-locale) for more information.
  *
  * ### Example
  *
@@ -35,7 +35,7 @@ export const LOCALE_ID = new InjectionToken<string>('LocaleId');
  * Use this token at bootstrap to provide the content of your translation file (`xtb`,
  * `xlf` or `xlf2`) when you want to translate your application in another language.
  *
- * See the {@linkDocs guide/i18n#merge i18n guide} for more information.
+ * See the [i18n guide](guide/i18n#merge) for more information.
  *
  * ### Example
  *
@@ -60,7 +60,7 @@ export const TRANSLATIONS = new InjectionToken<string>('Translations');
  * Provide this token at bootstrap to set the format of your {@link TRANSLATIONS}: `xtb`,
  * `xlf` or `xlf2`.
  *
- * See the {@linkDocs guide/i18n#merge i18n guide} for more information.
+ * See the [i18n guide](guide/i18n#merge) for more information.
  *
  * ### Example
  *
@@ -85,7 +85,7 @@ export const TRANSLATIONS_FORMAT = new InjectionToken<string>('TranslationsForma
  * - Warning (default): show a warning in the console and/or shell.
  * - Ignore: do nothing.
  *
- * See the {@linkDocs guide/i18n#missing-translation i18n guide} for more information.
+ * See the [i18n guide](guide/i18n#missing-translation) for more information.
  *
  * ### Example
  * ```typescript
diff --git a/packages/core/src/metadata/lifecycle_hooks.ts b/packages/core/src/metadata/lifecycle_hooks.ts
index cfa21b9dee..426752f28f 100644
--- a/packages/core/src/metadata/lifecycle_hooks.ts
+++ b/packages/core/src/metadata/lifecycle_hooks.ts
@@ -27,7 +27,7 @@ export interface SimpleChanges { [propName: string]: SimpleChange; }
  * and content children are checked if at least one of them has changed.
  * The `changes` parameter contains the changed properties.
  *
- * See {@linkDocs guide/lifecycle-hooks#onchanges "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#onchanges).
  *
  *
  */
@@ -45,7 +45,7 @@ export interface OnChanges { ngOnChanges(changes: SimpleChanges): void; }
  * first time, and before any of its children have been checked. It is invoked only once when the
  * directive is instantiated.
  *
- * See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks).
  *
  *
  */
@@ -69,7 +69,7 @@ export interface OnInit { ngOnInit(): void; }
  * See {@link KeyValueDiffers} and {@link IterableDiffers} for implementing custom dirty checking
  * for collections.
  *
- * See {@linkDocs guide/lifecycle-hooks#docheck "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#docheck).
  *
  *
  */
@@ -85,7 +85,7 @@ export interface DoCheck { ngDoCheck(): void; }
  * `ngOnDestroy` callback is typically used for any custom cleanup that needs to occur when the
  * instance is destroyed.
  *
- * See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks).
  *
  *
  */
@@ -100,7 +100,7 @@ export interface OnDestroy { ngOnDestroy(): void; }
  * Lifecycle hook that is called after a directive's content has been fully
  * initialized.
  *
- * See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#aftercontent).
  *
  *
  */
@@ -113,7 +113,7 @@ export interface AfterContentInit { ngAfterContentInit(): void; }
  * @description
  * Lifecycle hook that is called after every check of a directive's content.
  *
- * See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#aftercontent).
  *
  *
  */
@@ -127,7 +127,7 @@ export interface AfterContentChecked { ngAfterContentChecked(): void; }
  * Lifecycle hook that is called after a component's view has been fully
  * initialized.
  *
- * See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#afterview).
  *
  *
  */
@@ -140,7 +140,7 @@ export interface AfterViewInit { ngAfterViewInit(): void; }
  * @description
  * Lifecycle hook that is called after every check of a component's view.
  *
- * See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#afterview).
  *
  *
  */