The following portion is required:

• hm:// - the HyperDocs URL scheme

• d/ - the Entity Type ID

• DOCUMENT_ID - the ID of the Document to reference

The following are valid entity type identifiers

• d - Document Entity

• a - Account Entity

Additional types and conventions are reserved for future use

A link with only hm://d/DOCUMENT_ID is valid, but the entity may change over time. To link to the exact version of an Entity, include:

• ?v= - optional query parameter designating the version ref

• VERSION_REF - the CID(s) of the EntityChange that represent an exact version of the Entity, separated by periods (.)

When you link to Document Entities, you may deep-link to a specific block (section) of the document heirarchy. These are identified by block ID, as defined by the Document Entity.

A block reference points to a specific block within a Entity Reference or a Version Reference.

• hm://d/DOCUMENT_ID#BLOCK_REF - Block of Entity Ref

• hm://d/DOCUMENT_ID?v=VERSION_REF#BLOCK_REF - Block of Version Ref

A simple BLOCK_ID is a valid Block Ref, but it may also include a character range, pointing to a string within a block. This is a Block Range Ref:

BLOCK_ID:START:END

• BLOCK_ID - the block ID of the ref

• START - utf8 character point (offset) of the start of the range ref

• END - utf8 character point (offset) of the start of the range ref

The following are real example links:

• TODO