私は大きなMarkdown文書を書いています。文書のさまざまな場所へのリンクを提供する種類の目次を最初に配置したいと考えています。これどうやってするの？

使ってみた

[a link](# MyTitle)

MyTitleドキュメント内のタイトルはどこにあり、これは機能しませんでした。

でpandoc、このオプションを使用する場合--toc HTMLを生成するには、目次はセクションへのリンク、およびセクション見出しから内容のテーブルに戻って生成されます。これは、LaTeX、rtf、rstなど、他の形式のpandoc書き込みと同様です。したがって、コマンド

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

マークダウンのこのビット：

% 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.

これは、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は、ヘッダーからアンカータグを自動的に解析します。したがって、次のことができます。

[Custom foo description](#foo)

# Foo

上記の場合、Fooヘッダーは次の名前のアンカータグを生成しましたfoo

注：#すべての見出しサイズに1つのみ#、アンカー名とアンカー名の間にスペースはありません。アンカータグ名は小文字で、マルチワードの場合はダッシュで区切る必要があります。

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

### My Multi Word Header

更新

箱から出してpandocでも動作します。

実験して、私は使用している解決策を見つけました<div…/>が、明白な解決策は、ページ内の好きな場所に独自のアンカーポイントを配置することです。

<a name="abcde">

以前と

</a>

「リンク」したい行の後。次に、次のようなマークダウンリンク：

[link text](#abcde)

ドキュメントのどこにでも移動できます。

<div…/>解決策は、単に追加するには、「ダミー」部門を挿入するidプロパティを、これはページ構造に潜在的に破壊的であるが、<a name="abcde"/>解決策は非常に無害であるべき。

（PS：アンカーを入れてOKかもしれない中で次のようにあなたは、にリンクしたい行：

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

しかし、これはMarkdownがこれをどのように扱うかに依存します。たとえば、Stack Overflowの回答フォーマッターはこれで満足です！）

これは古いスレッドである可能性がありますが、Githubの
マークダウンで内部ドキュメントリンクを作成するには、次のように使用します（注：小文字の#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. 

良い質問がなされたので、私の回答を編集しました。

内部リンクは、使用して、任意のタイトルの大きさにすることができる- 、#、、## 私は下に...簡単な例を作成し https://github.com/aogilvie/markdownLinkTest#######

はい、markdownはこれを行いますが、名前anchorを指定する必要があります<a name='xyx'>。

完全な例、

これはリンクを作成します
[tasks](#tasks)

ドキュメントの後半で、名前付きアンカー（名前は何であれ）を作成します。

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

ヘッダーで囲むこともできます。

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

pandocマニュアルでは、識別子を使用してヘッダーにリンクする方法について説明しています。他のパーサーによるサポートについては確認しませんでしたが、githubでは動作しないことが報告されています。

識別子は手動で指定できます。

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

または、自動生成された識別子（この場合は#my-heading-text）を使用できます。どちらもpandocマニュアルで詳細に説明されています。

注：これは、HTML、LaTex、ConTeXt、Textile、またはAsciiDocに変換する場合にのみ機能します。

屋がこれまでに取得した場合心に留めておくべきいくつかの追加のもの空想を屋にナビゲートすることを見出し内のシンボルと...

# 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

...のようなもの#、;、&、と:の見出しの文字列の中には、一般的に/無視してストライプの代わりに、エスケープ、および1も使用することができますされている引用簡単に素早く利用するために、スタイルのリンクを。

ノート

GitHubは、:word:コミット、readmeファイルなどの構文をサポートしています。要点を using'emが重要である場合（rxaviersからの）。

そして、ほとんどすべての場所で、10進数または16進数を最新のブラウザーに使用できます。w3schoolsのチートシートは、特にCSS やシンボル付きの疑似要素を使用する方がスタイルに合っている場合は、非常に便利です。::before::after

ボーナスポイント？

万が一、見出し内の画像やその他のリンクがどのように解析されて、 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!"

注意事項

MarkDownレンダリングは場所によって異なるため、次のようなものです...

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

... GitHubには次の要素があります idます...

id="methodnameoptions--promise"

... バニラの衛生が結果としてid ...

id="methodnameoptions-codepromisecode"

...その書き込みを意味するか、テンプレートから値下げファイルをコンパイルのいずれか1つの方法を対象とする必要がslugifeing、または様々なために構成およびスクリプトロジックを追加する巧妙な場所は、見出しのテキストをきれいにしたいということな方法。

ユニバーサルソリューション

この質問は、マークダウンの実装によって異なる答えを持っているようです。
実際、公式のMarkdownドキュメントはこのトピックについては触れていません。
このような場合、およびポータブルソリューションが必要な場合は、HTMLを使用できます。

ヘッダーの前、または同じヘッダー行で、HTMLタグを使用してIDを定義します。
例えば：<a id="Chapter1"></a>
これはコードに表示されますが、レンダリングされたドキュメントには表示されません。

完全な例：

完全な例（オンラインおよび編集可能）はこちらを参照してください。

## 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.

この例をテストするには、コンテンツリストと最初の章の間にスペースを追加するか、ウィンドウの高さを低くする必要があります。
また、IDの名前にスペースを使用しないでください。

Markdown仕様にはそのようなディレクティブはありません。ごめんなさい。

GitlabはGitLab Flavored Markdown（GFM）を使用します

ここで「すべてのMarkdownでレンダリングされたヘッダーは自動的にIDを取得します」

マウスを使用して次のことができます。

• ヘッダーの上にマウスを移動
• ヘッダーから左側に表示されるホバーセレクターの上にマウスを移動します

• 右クリックでリンクをコピーして保存

  たとえば、README.mdファイルにはヘッダーがあります。

## series expansion formula of the Boettcher function

リンクを与える：

https://gitlab.com/adammajewski/parameter_external_angle/blob/master/README.md#series-expansion-formula-of-the-boettcher-function

プレフィックスを削除できるので、ここのリンクは単純です

file#header

ここでの意味：

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

今では次のように使用できます：

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

手動で行うこともできます。スペースをハイフン記号に置き換えます。

ライブ例はこちら

kramdownを使用すると、これはうまくいくようです：

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

それが言及されているのを見る

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

効率的に機能しますが、前者はヘッダー以外の要素や、複数の単語を含むヘッダーに適した代替手段になる場合があります。

MultiMarkdownがコメントのオプションとして言及されたので。

でMultiMarkdown内部リンクの構文は単純です。

ドキュメントの見出しについては、この形式で見出し名[heading][]を指定するだけで、内部リンクが作成されます。

詳細については、MultiMarkdown-5相互参照をご覧ください。

クロスリファレンス

よくリクエストされた機能は、Markdownが外部リンクを処理するのと同じくらい簡単にドキュメント内リンクを自動的に処理する機能でした。この目的のために、「Some Text」という名前のヘッダーが存在する場合、[Some Text] []をクロスリンクとして解釈する機能を追加しました。

例として、[メタデータ] []は、＃メタデータ（または##メタデータ、###メタデータ、####メタデータ、#####メタデータ、######メタデータ）に移動します。

あるいは、選択したオプションのラベルを含めて、複数のヘッダーが同じタイトルを持つ場合を明確にすることができます。

###概要[MultiMarkdownOverview] ##

これにより、[MultiMarkdownOverview]を使用してこのセクションを具体的に参照することができ、Overviewという別のセクションを参照することはできません。これは、atxスタイルまたはsettextスタイルのヘッダーで機能します。

ヘッダーで使用されているのと同じIDを使用してアンカーを既に定義している場合は、定義されたアンカーが優先されます。

ドキュメント内のヘッダーに加えて、相互参照にも使用できる画像や表のラベルを提供できます。

<a name="">トリックのいくつかのスピン：

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

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

上記の回答に加えて、

number_sections: trueYAMLヘッダーでオプションを設定する場合：

number_sections: TRUE

RMarkdownはセクションに自動番号を付けます。

これらの自動採番セクションを参照するには、Rマークダウンファイルに次の行を追加するだけです。

[My Section]

My Sectionセクションの名前はどこですか

これはセクションレベルに関係なく機能するようです。

# My section

## My section

### My section