To insert CSH destinations in your DITA document, use PI markers.
Markers provide the only way to insert mid-topic CSH destinations.
To provide a CSH destination with a marker:
Even if you insert the PI marker somewhere in the middle of a topic, clicking the associated button in the application takes the user to the beginning of the topic. However, you can provide mid-topic destinations by setting the following option in the configuration file:
[MSHtmlHelpOptions] ; UseAliasAName= No (default), ; or Yes (to allow midtopic jumps for CSH) UseAliasAName=Yes
First CSH link is to start of topic
When UseAliasAName=Yes, every CSH link except the very first goes directly to a mid-topic destination. Because of a defect in HTML Help, the CSH link for the first symbolic ID in your document always takes the user to the beginning of the topic that contains the relevant marker. If this is not acceptable, you can provide a dummy first entry by inserting a TopicAlias PI marker containing a dummy symbolic ID at the start of your DITA document. Also arrange for a dummy link to this destination; see §18.11.3 Specifying and generating a map file for CSH links.