[markdown] Markdown에서 동일한 문서의 일부에 링크하는 방법은 무엇입니까?

Program / 글쓴이

나는 큰 Markdown 문서를 작성하고 있으며 문서의 다양한 위치에 대한 링크를 제공하는 정렬 목차를 처음에 배치하고 싶습니다. 어떻게해야합니까?

나는 사용하려고 

[a link](# MyTitle)

MyTitle문서 내의 제목은 어디에 있으며 작동하지 않습니다.

답변

에서 pandoc 이 옵션을 사용하는 경우, --tocHTML을 생산, 내용의 테이블 섹션에 링크 및 섹션 제목에서 목차로 돌아 가기로 제작됩니다. 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

참고 : #모든 제목 크기에 대해 하나만 #, 앵커 이름과 사이에 공백이없고 앵커 태그 이름은 소문자 여야하며, 다중 Wor 일 경우 대시로 구분해야합니다 . d.

[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"/>솔루션은 무해해야합니다.

(추신 : 그것은 앵커 넣어 확인 될 수 있는 , 당신이 링크하고자하는 라인으로 다음과 같습니다 :

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

- [&#9889; Sunopsis](#9889-tldr)

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

- [Attribution]


------


## &#9889; TLDR


Words for those short on time or attention.


___


## It Grinds my :gear:s


Here _`:gear:`_ is not something like &#9881; or &#9965;


___


## &#9956; Attribution


Probably to much time at a keyboard



[Attribution]: #9956-attribution

… 일이 좋아 #, ;, &, 그리고 :문자열은 일반적으로 줄무늬 대신 탈출 / 무시되고있다 향하고 내에서, 하나는 또한 사용할 수 있습니다 인용 쉽고 빠르게 사용할 수 있도록 스타일 링크.

노트

GitHub의는 지원 :word:커밋에서 구문, readme 파일 등을 볼 수 요점 using’em가 관심 인 경우 (rxaviers에서 참조).

그리고 거의 모든 곳에서 최신 브라우저에는 십진수 또는 16 진수가 사용될 수 있습니다. 에서 치트 시트 W3 스쿨 입니다 퍼디 편리 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"

… 템플릿에서 MarkDown 파일을 쓰거나 컴파일하려면 한 가지 방법으로 대상 을 지정하거나 제목의 텍스트를 정리하는 것과 같은 다양한 영리한 방법에 대한 구성 및 스크립트 논리를 추가 해야합니다.