Document Linking

Use document links to move between related project documents or between headings in one document. The links are saved in the Markdown file, so they remain part of the document.

  1. Open the Markdown document in ThinkForge's rich-text editor.
  2. Place the caret where the link should appear.
  3. Type [[, then at least two characters of the target's title, path, or a tag.
  4. Use the Up and Down arrows to choose a result.
  5. Press Enter or Tab to insert it. Press Escape to dismiss the list.
  6. Save the document.

Each result shows a title and project-relative path. The badges indicate a keyword (kw), meaning (SK), or tag (tag) match. The document you are editing is excluded.

Insert → Document Link opens the same search.

Choose the link text

The inserted link uses the target's title. You can edit those words afterward without changing the destination. Selecting words before typing [[ does not use them as the link label.

The link keeps working when the target is renamed or moved inside ThinkForge. Its visible label does not update automatically.

Use the adjacent Link command for a web address, email address, relative file path, or copied link.

  1. Open Project Navigator.
  2. In Files, open the document's focused reader.
  3. Select Copy document link.
  4. Paste the copied value where you need it.

The copied value begins with thinkforge://document/. When writing Markdown manually, place that entire value behind a label:

[Project notes](paste-the-copied-link-here)

Use the value ThinkForge copied. Do not invent or edit the document identifier.

Create a table of contents

Add headings, place the caret where the list should appear, and choose Insert → Contents. Save the document. Select an entry to jump to its heading.

The result is a flat list of ordinary Markdown links. It is a snapshot: after changing headings, update the list yourself or delete it and insert a new one.

A heading link starts with # followed by the heading fragment:

[Create a table of contents](#create-a-table-of-contents)

Heading fragments use lowercase words separated by hyphens. Repeated headings get suffixes such as -2 or -3.

A copied document link or relative file link can also include a heading fragment. The [[ search inserts the document destination; add the fragment yourself when needed.

In Project Navigator's focused reader or the rich-text editor, select a document link to open its target, or a heading link to scroll to that section. Web and email links open in the application configured for them.

Project Navigator keeps indexed document navigation in its reader. Use its Back control to return to the folder listing.

Relative file links such as ../Project Navigator/Content View.md are useful when the same documents must work in another Markdown reader or on a website. ThinkForge application links generally open only in ThinkForge.

A document link is part of the written content. Use it for references, reading paths, and contents lists.

A manual relationship in Project Navigator connects documents with an intent such as Supports or Contradicts. Insights and Clusters use those relationships. Creating a document link does not create a manual relationship, and creating a relationship does not insert text into either document.

If a target is missing from [[ results, confirm that it is a supported document in the current project and has been indexed. Type at least two characters. The document you are editing will not appear.

The link search is available in the document's rich-text editor. It does not return results in the Smart Clipboard composer.

If a contents entry jumps to the wrong place, the heading may have changed or may be repeated. Recreate the contents list or correct the fragment.

If an internal link does nothing, confirm that the target still exists and is indexed. ThinkForge has no broken-link report or repair dialog. Dragging a document into the editor does not create a link; use [[ or Copy document link.