TechArticle

wiki link

Infobox

headline: wiki link
description: Suggest missing wikilinks and repair unambiguous broken internal links.

Suggest missing wikilinks for plain-text mentions of other wiki pages, or repair broken internal links when the fix is unambiguous. Report-only by default — mutations require explicit flags.

Usage

wiki link
wiki link wiki/Some_Page.md
wiki link wiki/A.md wiki/B.md
wiki link -v
wiki link --check
wiki link --dry-run --apply
wiki link --apply
wiki link --fix-broken
wiki link --fix-broken --dry-run

Options

Flag	Description
`FILE...`	Optional markdown paths; otherwise entire wiki
`--apply`	Insert internal links for each suggestion (body only, never frontmatter); format from `link.style` in wiki.yaml (`standard` or `wikilink`)
`--fix-broken`	Repair unambiguous broken wikilinks and internal markdown page links
`-n`, `--dry-run`	Preview `--apply` or `--fix-broken` without writing files
`-c`, `--check`	Exit 1 if opportunities or broken links remain (CI gate)
`-v`, `--verbose`	Include target titles in report output; print changed files when applying

Detection rules

Missing-link suggestions skip:

Existing wikilinks and markdown links
Fenced and inline code
Self-links and overlapping aliases (longest alias wins)
Short single-word acronyms (for example HTML, JSON) unless the page slug humanizes to the same text

Broken-link repair (--fix-broken) only runs when:

The target page rename is listed in link.renames (see Wiki Configuration)
A unique fuzzy route match exists among wiki pages
A unique fuzzy heading fragment exists on the target page

It never auto-creates pages or deletes links. Asset links, metadata CURIEs, and ambiguous matches stay manual.

Why not check or lint?

wiki lint is the convention lane — broken links, filename pattern, heading style, and link style. It reports but does not edit files; repair is wiki link --fix-broken. Missing wikilinks are optional enrichment, not a lint violation.
wiki check is the integrity lane — SHACL, JSON Schema frontmatter, routes, collisions, layout frontmatter. It does not scan prose for broken links.
wiki link requires explicit --apply or --fix-broken because suggestions are heuristic and repairs are conservative by design.
See Design Philosophies for the full lane model.

Wiki Subcommand lint — convention lane (lint.broken_links)
Wiki Subcommand check — integrity lane (SHACL, JSON Schema, routes, layout)
Style Guide — internal link conventions
Wiki CLI

ContentsOn this page

[hide]

(Top)
Usage
Options
Detection rules
Why not check or lint?
Related

Backlinks

Categories:

TechArticle

Talk / Local Notes: wiki link

Your personal scratchpad for this page (saved locally in browser)

0 characters

View Source: wiki link

Raw Markdown source code of the document

# `wiki link`

Suggest **missing wikilinks** for plain-text mentions of other wiki pages, or **repair** broken internal links when the fix is unambiguous. Report-only by default — mutations require explicit flags.

## Usage

```bash
wiki link
wiki link wiki/Some_Page.md
wiki link wiki/A.md wiki/B.md
wiki link -v
wiki link --check
wiki link --dry-run --apply
wiki link --apply
wiki link --fix-broken
wiki link --fix-broken --dry-run
```

## Options

| Flag              | Description                                                                                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FILE...`         | Optional markdown paths; otherwise entire wiki                                                                                                                      |
| `--apply`         | Insert internal links for each suggestion (body only, never frontmatter); format from `link.style` in [wiki.yaml](Wiki_Configuration.md) (`standard` or `wikilink`) |
| `--fix-broken`    | Repair unambiguous broken wikilinks and internal markdown page links                                                                                                |
| `-n`, `--dry-run` | Preview `--apply` or `--fix-broken` without writing files                                                                                                           |
| `-c`, `--check`   | Exit 1 if opportunities or broken links remain (CI gate)                                                                                                            |
| `-v`, `--verbose` | Include target titles in report output; print changed files when applying                                                                                           |

## Detection rules

Missing-link suggestions skip:

- Existing wikilinks and markdown links
- Fenced and inline code
- Self-links and overlapping aliases (longest alias wins)
- Short single-word acronyms (for example `HTML`, `JSON`) unless the page slug humanizes to the same text

Broken-link repair (`--fix-broken`) only runs when:

- The target page rename is listed in `link.renames` (see [Wiki Configuration](Wiki_Configuration.md))
- A unique fuzzy route match exists among wiki pages
- A unique fuzzy heading fragment exists on the target page

It never auto-creates pages or deletes links. Asset links, metadata CURIEs, and ambiguous matches stay manual.

## Why not check or lint?

- **`wiki lint`** is the convention lane — broken links, filename pattern, heading style, and link style. It reports but does not edit files; repair is `wiki link --fix-broken`. Missing wikilinks are optional enrichment, not a lint violation.
- **`wiki check`** is the integrity lane — SHACL, JSON Schema frontmatter, routes, collisions, layout frontmatter. It does not scan prose for broken links.
- **`wiki link`** requires explicit `--apply` or `--fix-broken` because suggestions are heuristic and repairs are conservative by design.
- See [Design Philosophies](Design_Philosophies.md#check-lint-fmt-and-link) for the full lane model.

## Related

- [Wiki Subcommand lint](Wiki_Subcommand_lint.md) — convention lane (`lint.broken_links`)
- [Wiki Subcommand check](Wiki_Subcommand_check.md) — integrity lane (SHACL, JSON Schema, routes, layout)
- [Style Guide](Style_Guide.md) — internal link conventions
- [Wiki CLI](Wiki_CLI.md)

Metadata: wiki link

RDF representation compiled from frontmatter

{
  "@context": {
    "schema": "https://schema.org/",
    "wiki": "https://wazootech.github.io/wiki/"
  },
  "@id": "wiki:Wiki_Subcommand_link",
  "@type": "schema:TechArticle",
  "schema:description": "Suggest missing wikilinks and repair unambiguous broken internal links.",
  "schema:headline": "wiki link"
}

@prefix schema: <https://schema.org/> .
@prefix wiki: <https://wazootech.github.io/wiki/> .

wiki:Wiki_Subcommand_link a schema:TechArticle ;
    schema:description "Suggest missing wikilinks and repair unambiguous broken internal links." ;
    schema:headline "wiki link" .

@prefix schema: <https://schema.org/> .
@prefix wiki: <https://wazootech.github.io/wiki/> .

wiki:Wiki_Subcommand_link a schema:TechArticle ;
    schema:description "Suggest missing wikilinks and repair unambiguous broken internal links." ;
    schema:headline "wiki link" .

<?xml version="1.0" encoding="utf-8"?>
<rdf:RDF
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:schema="https://schema.org/"
>
  <rdf:Description rdf:about="https://wazootech.github.io/wiki/Wiki_Subcommand_link">
    <rdf:type rdf:resource="https://schema.org/TechArticle"/>
    <schema:headline>wiki link</schema:headline>
    <schema:description>Suggest missing wikilinks and repair unambiguous broken internal links.</schema:description>
  </rdf:Description>
</rdf:RDF>

<https://wazootech.github.io/wiki/Wiki_Subcommand_link> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schema.org/TechArticle> .
<https://wazootech.github.io/wiki/Wiki_Subcommand_link> <https://schema.org/headline> "wiki link" .
<https://wazootech.github.io/wiki/Wiki_Subcommand_link> <https://schema.org/description> "Suggest missing wikilinks and repair unambiguous broken internal links." .

@prefix schema: <https://schema.org/> .
@prefix wiki: <https://wazootech.github.io/wiki/> .

_:Ne793c6427f5b4318aef80eee49ce2c20 {
    wiki:Wiki_Subcommand_link a schema:TechArticle ;
        schema:description "Suggest missing wikilinks and repair unambiguous broken internal links." ;
        schema:headline "wiki link" .
}

<https://wazootech.github.io/wiki/Wiki_Subcommand_link> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schema.org/TechArticle> .
<https://wazootech.github.io/wiki/Wiki_Subcommand_link> <https://schema.org/headline> "wiki link" .
<https://wazootech.github.io/wiki/Wiki_Subcommand_link> <https://schema.org/description> "Suggest missing wikilinks and repair unambiguous broken internal links." .