Headings as Links and Anchors

Introduction

It is possible to use section headings as links to other pages and as destination anchors for links. A linked heading will appear in the table of contents but not in the document itself. An anchored heading allows you to link to a particular section from within the same page or from another document. In either case, the syntax is similar to embedded hypertext links and anchors.

Linked Headings

To link a heading, add a pound sign (#) and a relative or complete URL after the heading text:

  #A Linked Heading#link.html

This link will appear in the table of contents at the top of the document. It will not appear as a section heading in the body of the document.

Anchored Headings

To use a heading as an anchor, add a pound sign (#), an equal sign (=), and a unique name for the anchor:

  #An Anchored Heading#=ANCHOR

The heading text will appear as a section heading and in the table of contents as it normally would. To link directly to the heading, create a link of the form:

  {#Link to Section##ANCHOR#} or {#Link to Section#myfile.html#ANCHOR#}

Note that anchor names are case sensitive ("ANCHOR" does not equal "anchor").