나는 큰 Markdown 문서를 작성하고 있으며 문서의 다양한 위치에 대한 링크를 제공하는 정렬 목차를 처음에 배치하고 싶습니다. 어떻게해야합니까?
나는 사용하려고
[a link](# MyTitle)
MyTitle
문서 내의 제목은 어디에 있으며 작동하지 않습니다.
나는 큰 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>
git clone
가장 낮은 또는 가장 바깥의 tmbundle 디렉토리에 -ed 되어야합니다 ~/Library/Application\ Support/TextMate/Bundles
.
-1
id의 첫 번째 반복 -2
, 두 번째 등에 추가 됩니다 .
Github는 자동으로 헤더에서 앵커 태그를 구문 분석합니다. 따라서 다음을 수행 할 수 있습니다.
[Custom foo description](#foo)
# Foo
위의 경우 Foo
헤더는 이름으로 앵커 태그를 생성했습니다.foo
참고 : #
모든 제목 크기에 대해 하나만 #
, 앵커 이름과 사이에 공백이없고 앵커 태그 이름은 소문자 여야하며, 다중 Wor 일 경우 대시로 구분해야합니다 . d.
[click on this link](#my-multi-word-header)
### My Multi Word Header
함께 사용할 수 pandoc
있습니다.
[just](#like-this-one)
.
## Foo
[이것은 Foo에 대한 링크입니다] (# foo) ... 즉 , 단일 해시, 해시와 소문자-케밥-케이스-이름- 의 헤더
실험을 통해 솔루션을 찾았 <div…/>
지만 확실한 해결책은 원하는 위치에 자신의 앵커 포인트를 페이지에 배치하는 것입니다.
<a name="abcde">
이전 과
</a>
후 선 당신에게 '링크'에합니다. 그런 다음 마크 다운 링크는 다음과 같습니다.
[link text](#abcde)
문서의 어느 곳 으로든 이동합니다.
이 <div…/>
솔루션은 id
속성 을 추가하기 위해 "더미"구분을 삽입하며 이는 페이지 구조를 방해 할 가능성이 있지만 <a name="abcde"/>
솔루션은 무해해야합니다.
(추신 : 그것은 앵커 넣어 확인 될 수 있는 , 당신이 링크하고자하는 라인으로 다음과 같습니다 :
## <a name="head1">Heading One</a>
그러나 이것은 Markdown이 이것을 어떻게 처리하는지에 달려 있습니다. 예를 들어 Stack Overflow 응답 포맷터가 이것에 만족합니다!)
## headers
.
<div/>
몇 줄이 있는 텍스트 가 영향을 받는다는 것을 알았습니다 . 대신 전체 div
태그 절에 연결하는 텍스트를 래핑 해야하며 실제 HTML을 사용하여 처음부터 동작을 다시 지정해야합니다. 우우.
이것은 오래된 스레드 일 수 있지만 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
(#dependencies-title)
은 Github 마크 다운에 내부 링크임을 알려줍니다. 뒤에 나오는 텍스트는 모든 제목 크기 일 수 있습니다. 다음은 제가 만든 테스트 예입니다 ... https://github.com/aogilvie/markdownLinkTest
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
... 일이 좋아 #
, ;
, &
, 그리고 :
문자열은 일반적으로 줄무늬 대신 탈출 / 무시되고있다 향하고 내에서, 하나는 또한 사용할 수 있습니다 인용 쉽고 빠르게 사용할 수 있도록 스타일 링크.
노트
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 파일을 쓰거나 컴파일하려면 한 가지 방법으로 대상 을 지정하거나 제목의 텍스트를 정리하는 것과 같은 다양한 영리한 방법에 대한 구성 및 스크립트 논리를 추가 해야합니다.
이 질문은 markdown 구현에 따라 다른 답변을 가지고있는 것 같습니다.
실제로, 공식 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 이름에 공백을 사용하지 마십시오.
## Chapter 1
그 위에 열린 줄이 필요합니다. (2). 링크가 작동하지 않습니다 ...
<span id="Chapter1"><span>
마크 다운 사양에는 그러한 지시문이 없습니다. 죄송합니다.
Gitlab은 GitLab Flavored Markdown (GFM)을 사용합니다
여기에 "마크 다운 렌더링 된 모든 헤더가 자동으로 ID를 얻습니다"
마우스를 사용하여 다음을 수행 할 수 있습니다.
마우스 오른쪽 버튼을 클릭하여 링크 복사 및 저장
예를 들어 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)
공백을 하이픈 기호로 바꾸십시오.
라이브 예는 여기
코멘트에서 MultiMarkdown이 옵션으로 언급되었으므로.
에서는 MultiMarkdown 내부 링크에 대한 구문은 간단하다.
문서의 제목에이 제목으로 이름을 지정 [heading][]
하면 내부 링크가 만들어집니다.
자세한 내용은 다음을 참조하십시오 : MultiMarkdown-5 Cross-references .
상호 참조
자주 요청되는 기능은 Markdown이 외부 링크를 처리하는 것처럼 쉽게 문서 내 링크를 자동으로 처리 할 수있는 기능이었습니다. 이를 위해“Some Text”라는 헤더가있는 경우 [Some Text] []를 교차 링크로 해석하는 기능을 추가했습니다.
예를 들어 [Metadata] []는 # 메타 데이터 (또는 ## 메타 데이터, ### 메타 데이터, #### 메타 데이터, ##### 메타 데이터, ###### 메타 데이터)로 이동합니다.
또는 여러 헤더가 동일한 제목을 갖는 경우를 명확하게하기 위해 선택 사항의 선택적인 레이블을 포함 할 수 있습니다.
### 개요 [MultiMarkdownOverview] ##
이를 통해 [MultiMarkdownOverview]를 사용하여이 섹션을 구체적으로 참조 할 수 있으며 Overview라는 다른 섹션은 참조 할 수 없습니다. 이것은 atx 또는 settext 스타일 헤더와 함께 작동합니다.
헤더에서 사용하는 것과 동일한 ID를 사용하여 앵커를 이미 정의한 경우 정의 된 앵커가 우선합니다.
문서 내의 헤더 외에도 이미지 및 표에 레이블을 제공하여 상호 참조에 사용할 수 있습니다.