Tôi đang viết một tài liệu Markdown lớn và muốn đặt một bảng nội dung các loại ở đầu sẽ cung cấp các liên kết đến các vị trí khác nhau trong tài liệu. Tôi có thể làm cái này như thế nào?

Tôi đã thử sử dụng

[a link](# MyTitle)

nơi MyTitlelà một tiêu đề trong tài liệu và điều này đã không làm việc.

Trong pandoc , nếu bạn sử dụng tùy chọn --toctrong việc tạo html, một mục lục sẽ được tạo với các liên kết đến các phần và quay lại mục lục từ các tiêu đề của phần. Nó tương tự với các định dạng khác mà pandoc viết, như LaTeX, rtf, rst, v.v. Vì vậy, với lệnh

pandoc --toc happiness.txt -o happiness.html

chút đánh dấu này:

% True Happiness

Introduction
------------

Many have posed the question of true happiness.  In this blog post we propose to
solve it.

First Attempts
--------------

The earliest attempts at attaining true happiness of course aimed at pleasure. 
Soon, though, the downside of pleasure was revealed.

sẽ mang lại điều này như phần thân của html:

<h1 class="title">
    True Happiness
</h1>
<div id="TOC">
    <ul>
        <li>
            <a href="#introduction">Introduction</a>
        </li>
        <li>
            <a href="#first-attempts">First Attempts</a>
        </li>
    </ul>
</div>
<div id="introduction">
    <h2>
        <a href="#TOC">Introduction</a>
    </h2>
    <p>
        Many have posed the question of true happiness. In this blog post we propose to solve it.
    </p>
</div>
<div id="first-attempts">
    <h2>
        <a href="#TOC">First Attempts</a>
    </h2>
    <p>
        The earliest attempts at attaining true happiness of course aimed at pleasure. Soon, though, the downside of pleasure was revealed.
    </p>
</div>

Github tự động phân tích các thẻ neo ra khỏi tiêu đề của bạn. Vì vậy, bạn có thể làm như sau:

[Custom foo description](#foo)

# Foo

Trong trường hợp trên, Footiêu đề đã tạo ra một thẻ neo với tênfoo

Lưu ý : chỉ một #cho tất cả các kích thước tiêu đề, không có khoảng trắng giữa #và tên neo , tên thẻ neo phải là chữ thường và được phân cách bằng dấu gạch ngang nếu có nhiều từ .

[click on this link](#my-multi-word-header)

### My Multi Word Header

Cập nhật

Làm việc ra khỏi hộp với pandocquá.

Thử nghiệm, tôi đã tìm thấy một giải pháp bằng cách sử dụng <div…/>nhưng một giải pháp rõ ràng là đặt điểm neo của riêng bạn vào trang bất cứ nơi nào bạn muốn, do đó:

<a name="abcde">

trước và

</a>

sau dòng bạn muốn 'liên kết' đến. Sau đó, một liên kết đánh dấu như:

[link text](#abcde)

bất cứ nơi nào trong tài liệu sẽ đưa bạn đến đó.

Các <div…/>giải pháp chèn một "dummy" bộ phận chỉ để thêm các idbất động sản, và điều này là có khả năng gây gián đoạn cho các cấu trúc trang, nhưng <a name="abcde"/>giải pháp nên được khá vô hại.

(PS: Có thể ổn khi đặt neo vào dòng bạn muốn liên kết đến, như sau:

## <a name="head1">Heading One</a>

nhưng điều này phụ thuộc vào cách Markdown đối xử với điều này. Tôi lưu ý, ví dụ, trình định dạng câu trả lời Stack Overflow hài lòng với điều này!)

Đây có thể là luồng lỗi thời nhưng để tạo các liên kết tài liệu bên trong đánh dấu trong Github sử dụng ...
(LƯU Ý: chữ thường #title)

    # Contents
     - [Specification](#specification) 
     - [Dependencies Title](#dependencies-title) 

    ## Specification
    Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. 

    ## Dependencies Title
    Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. 

Một câu hỏi hay đã được đưa ra nên tôi đã chỉnh sửa câu trả lời của mình;

Một liên kết bên trong có thể được thực hiện đối với bất kỳ kích thước tiêu đề sử dụng - #, ##, ###, #### Tôi tạo ra một ví dụ nhanh dưới đây ... https://github.com/aogilvie/markdownLinkTest

có, markdown thực hiện điều này nhưng bạn cần chỉ định tên neo <a name='xyx'>.

một ví dụ đầy đủ,

điều này tạo ra liên kết
[tasks](#tasks)

sau đó trong tài liệu, bạn tạo neo được đặt tên (bất cứ cái gì nó được gọi).

<a name="tasks">
   my tasks
</a>

lưu ý rằng bạn cũng có thể bọc nó xung quanh tiêu đề quá.

<a name="tasks">
### Agile tasks (created by developer)
</a>

Hướng dẫn pandoc giải thích cách liên kết với các tiêu đề của bạn, bằng cách sử dụng định danh của họ. Tôi đã không kiểm tra sự hỗ trợ này bởi các trình phân tích cú pháp khác, nhưng nó đã được báo cáo rằng nó không hoạt động trên github .

Mã định danh có thể được chỉ định bằng tay:

## my heading text {#mht}
Some normal text here,
including a [link to the header](#mht).

hoặc bạn có thể sử dụng mã định danh được tạo tự động (trong trường hợp này #my-heading-text). Cả hai đều được giải thích chi tiết trong hướng dẫn sử dụng pandoc .

LƯU Ý : Điều này chỉ hoạt động khi chuyển đổi sang HTML , LaTex , ConTeXt , Dệt may hoặc AsciiDoc .

Một số điều cần lưu ý nếu bạn có thể thích các biểu tượng trong các tiêu đề mà bạn muốn điều hướng đến ...

# What this is about


------


#### Table of Contents


- [About](#what-this-is-about)

- [⚡ Sunopsis](#9889-tldr)

- [:gear: Grinders](#it-grinds-my-gears)

- [Attribution]


------


## ⚡ TLDR


Words for those short on time or attention.


___


## It Grinds my :gear:s


Here _`:gear:`_ is not something like ⚙ or ⛭


___


## ⛤ Attribution


Probably to much time at a keyboard



[Attribution]: #9956-attribution

... điều thích #, ;, &, và :trong tiến chuỗi thường được bỏ qua / sọc thay vì bỏ đi, và người ta cũng có thể sử dụng trích dẫn liên kết phong cách để tận dụng nhanh chóng dễ dàng hơn.

Ghi chú

GitHub hỗ trợ :word:cú pháp trong các xác nhận, các tệp readme, v.v. hãy xem ý chính (từ rxaviers) nếu việc sử dụng được quan tâm ở đó.

Và đối với mọi nơi khác, số thập phân hoặc thập lục phân có thể được sử dụng cho các trình duyệt hiện đại; cheat-sheet từ w3schools là purdy tiện dụng , đặc biệt là nếu sử dụng CSS ::beforehoặc ::aftergiả yếu tố với các biểu tượng là hơn phong cách của bạn.

Điểm thưởng?

Chỉ trong trường hợp ai đó đang tự hỏi làm thế nào hình ảnh và các liên kết khác trong một tiêu đề được phân tích cú pháp thành id...

- [Imaged](#alt-textbadge__examplehttpsexamplecom-to-somewhere)


## [![Alt Text][badge__example]](https://example.com) To Somewhere


[badge__example]:
  https://img.shields.io/badge/Left-Right-success.svg?labelColor=brown&logo=stackexchange
  "Eeak a mouse!"

Hãy cẩn thận

Kết xuất MarkDown khác nhau từ nơi này sang nơi khác, vì vậy những thứ như ...

## methodName([options]) => <code>Promise</code>

... trên GitHub sẽ có một yếu tố idnhư ...

id="methodnameoptions--promise"

... nơi mà việc vệ sinh vani sẽ dẫn đến một id...

id="methodnameoptions-codepromisecode"

... có nghĩa là viết hoặc biên dịch các tệp MarkDown từ các mẫu hoặc yêu cầu nhắm mục tiêu một cách slugifeing , hoặc thêm cấu hình và logic theo kịch bản cho các cách thông minh khác nhau mà muốn làm sạch văn bản của tiêu đề.

Giải pháp phổ quát

Câu hỏi này dường như có một câu trả lời khác nhau theo cách thực hiện markdown.
Trên thực tế, tài liệu Markdown chính thức im lặng về chủ đề này.
Trong những trường hợp như vậy và nếu bạn muốn một giải pháp di động, bạn có thể sử dụng HTML.

Trước bất kỳ tiêu đề nào, hoặc trong cùng một dòng tiêu đề, hãy xác định ID bằng cách sử dụng một số thẻ HTML.
Ví dụ: <a id="Chapter1"></a>
Bạn sẽ thấy điều này trong mã của bạn nhưng không có trong tài liệu được kết xuất.

Ví dụ đầy đủ:

Xem một ví dụ đầy đủ (trực tuyến và có thể chỉnh sửa) ở đây .

## Content

* [Chapter 1](#Chapter1)
* [Chapter 2](#Chapter2)

<div id="Chapter1"></div>
## Chapter 1

Some text here.  
Some text here.
Some text here.

## Chapter 2 <span id="Chapter2"><span>

Some text here.  
Some text here.
Some text here.

Để kiểm tra ví dụ này, bạn phải thêm một số khoảng trống giữa danh sách nội dung và chương đầu tiên hoặc giảm chiều cao cửa sổ.
Ngoài ra, không sử dụng khoảng trắng trong tên của id.

Không có chỉ thị như vậy trong thông số Markdown. Lấy làm tiếc.

Gitlab sử dụng GitLab Flavored Markdown (GFM)

Ở đây "tất cả các tiêu đề được hiển thị Markdown tự động nhận ID"

Người ta có thể sử dụng chuột để:

• di chuyển chuột trên tiêu đề
• di chuyển chuột qua bộ chọn di chuột mà hiển thị bên trái từ tiêu đề

• sao chép và lưu liên kết bằng cách nhấp chuột phải

  Ví dụ: trong tệp README.md tôi có tiêu đề:

## series expansion formula of the Boettcher function

cung cấp một liên kết:

https://gitlab.com/adammajewski/parameter_external_angle/blob/master/README.md#series-Exansion-formula-of-the-boettcher-f ghép

Tiền tố có thể được gỡ bỏ để liên kết ở đây chỉ đơn giản là

file#header

có nghĩa là:

README.md#series-expansion-formula-of-the-boettcher-function

Bây giờ nó có thể được sử dụng như:

[series expansion formula of the Boettcher function](README.md#series-expansion-formula-of-the-boettcher-function)

Người ta cũng có thể làm điều đó bằng tay: thay thế dấu cách bằng dấu gạch nối.

Ví dụ trực tiếp là đây

Sử dụng kramdown, có vẻ như điều này hoạt động tốt:

[I want this to link to foo](#foo)
....
....
{: id="foo"}
### Foo are you?

Tôi thấy nó đã được đề cập rằng

[foo][#foo]
....
#Foo

hoạt động hiệu quả, nhưng trước đây có thể là một sự thay thế tốt cho các yếu tố bên cạnh các tiêu đề hoặc các tiêu đề khác có nhiều từ.

Vì MultiMarkdown đã được đề cập như một tùy chọn trong các bình luận.

Trong MultiMarkdown , cú pháp cho một liên kết nội bộ rất đơn giản.

Đối với bất kỳ tiêu đề nào trong tài liệu chỉ cần cung cấp tên tiêu đề ở định dạng này [heading][]để tạo liên kết nội bộ.

Đọc thêm tại đây: MultiMarkdown-5 Tài liệu tham khảo chéo .

Tài liệu tham khảo chéo

Một tính năng được yêu cầu là khả năng Markdown tự động xử lý các liên kết trong tài liệu dễ dàng như xử lý các liên kết bên ngoài. Với mục đích này, tôi đã thêm khả năng diễn giải [Một số văn bản] [] dưới dạng một liên kết chéo, nếu một tiêu đề có tên là Một số văn bản có thể tồn tại.

Ví dụ: [Siêu dữ liệu] [] sẽ đưa bạn đến # Siêu dữ liệu (hoặc bất kỳ ## Siêu dữ liệu, ### Siêu dữ liệu, #### Siêu dữ liệu, ##### Siêu dữ liệu, ###### Siêu dữ liệu).

Ngoài ra, bạn có thể bao gồm một nhãn tùy chọn mà bạn chọn để giúp phân biệt các trường hợp có nhiều tiêu đề có cùng tiêu đề:

### Tổng quan [MultiMarkdownOverview] ##

Điều này cho phép bạn sử dụng [MultiMarkdownOverview] để tham khảo cụ thể phần này và không phải phần khác có tên Tổng quan. Điều này hoạt động với các tiêu đề kiểu atx- hoặc lắng đọng.

Nếu bạn đã xác định một neo sử dụng cùng một id được sử dụng bởi một tiêu đề, thì neo được xác định sẽ được ưu tiên.

Ngoài các tiêu đề trong tài liệu, bạn có thể cung cấp nhãn cho hình ảnh và bảng mà sau đó cũng có thể được sử dụng để tham khảo chéo.

Một số vòng quay khác về <a name="">mẹo:

<a id="a-link"></a> Title
------

#### <a id="a-link"></a> Title (when you wanna control the h{N} with #'s)

Ngoài các câu trả lời trên,

Khi đặt tùy chọn number_sections: truetrong tiêu đề YAML:

number_sections: TRUE

RMarkdown sẽ tự động đánh số phần của bạn.

Để tham chiếu các phần được đánh số tự động đó, chỉ cần đặt phần sau vào tệp R Markdown của bạn:

[My Section]

Trong trường hợp My Sectionlà tên của phần này

Điều này dường như hoạt động bất kể cấp độ phần:

# My section

## My section

### My section