My Awesome Book

There are two ways to make inter documents cross reference

reference id test

reference id with ...

reference id without ..

Gitbook style reference id tag is

# Hello {#id}

reference id with gitbook style

# test new tag {#new-tag}

reference id having ... with gitbook style(it doesn't work)

# test new tag with ... {#new ... tag}

dash reference id having ... with gitbook style(it doesn't work)

# dash test new tag with ...{#new-...-tag}

HTML anchor tag

referce test type inference section in chapter1.md

markdown syntax for an inter-document cross reference

[type inference section in chapter1.md](chapter1.md#type_inference)

chapter1 section header tag :

# <a name="type_inference"></a>type inference

Without HTML tag

how to create the reference

• create

# [reference_title](#reference_id)

• access

[some description](reference_file_name#reference_id)

naming convention for an reference id

• use the same reference title name in the reference id field

in chapter1.md

# [same][#same]

access to same section in chapter1.md

[same name in chapter1.md](chapter1.md#same)

• reference id with dash

You can set a long reference id.

in chapter1.md

# [long title name reference](#long-title-name-reference)

access to long title name reference section in chapter1.md

[long title name reference](#long-title-name-reference)

naming convetion limitations for an reference id

A reference id must be equal to reference_title. Or use - to match with reference title. Also, it is not allow to work with _, space.

• different name

in chapter1.md

# [different title](#different)

You can not access directly different section.

[different title](chapter1.md#different)

• same name with _

  [same name with `_`](chapter1.md#same_name)
  

• name with space

[name with space](chapter1.md#space name)