2017-04-07 1 views
1

길게 README.md 파일을 생성해야하며 처음에는 차례와 같은 다른 섹션에 대한 링크가 필요합니다. 마크 다운 링크로 섹션 제목을 번역 :마크 업 제목을 HTML 앵커로 변환하는 규칙은 무엇입니까?

이것은 제목과 내용의 테이블에 대한 링크를 생성하기 위해

마크 다운

의 링크, 난 앵커에 대한 값이 필요합니다. 내가 가진 텍스트. 조각에는 규칙이 필요합니다. 아마도 이것은 다음과 같습니다 :

[This is a heading and a link in Markdown](#thisisaheadingandalinkinmarkdown) 

markdown의 제목이 앵커/단편 값으로 변환되는 규칙을 아는 사람이 있습니까?

답변

1

가 인하 헤더에서 앵커를 생성하는 방법을 GitLab documentation 상태 : 모든 텍스트는

  • 모든 단어가 아닌 텍스트를 소문자로 변환됩니다
    1. (예, 구두점, HTML)이 제거됩니다
    2. 모든 공백이 하이픈으로 변환됩니다.
    3. 행의 두 개 이상의 하이픈이 하나로 변환됩니다.
    4. 동일한 ID를 가진 헤더가 이미 벌이면 N 생성 된 고유 증가 수는이 내가 어떤 명확한 규칙을 찾을 수 있지만 # Standard markdown의 앵커 standard-markdown

      로 변환 될 수 있다는 것을 의미 1.

    에서 시작, 추가됩니다 GitHub이 앵커를 생성하는 방법에 대해서는 몇 가지를 확인하는 것 같습니다. README.md 위의 규칙 대부분이 GitHub에도 적용됩니다.

  • 0

    표준 Markdown 기능이 아닌 헤더 텍스트를 앵커로 변환합니다. 원래 규칙은이 규칙에 대한 언급이 없으며 참조 구현은 기능을 제공하지 않습니다. 따라서 다양한 구현 방법은 고유 한 규칙 집합을 만들었으며 각 규칙은 서로 다릅니다. @ Fairy의 대답은 Gitlab에서 사용하는 규칙을 설명합니다.

    GitHub는 앵커에 대해 언급하지 않는 사양을 게시했습니다. 실제로 headers 섹션에는 태그에 ID가 정의되지 않은 예제가 표시됩니다. 아마도 그들은 markup 프로젝트에서 포스트 프로세서로 추가하기 때문일 것입니다. 하지만 게시 된 규칙은 없습니다. 규칙을 적용하려면 source code을 읽어야합니다. 코드를 살펴보면, 규칙은 GitLab과 동일하게 보이지만, 다양한 엣지 경우를 신중하게 테스트 할 때만 명백한 약간의 차이가있을 수 있습니다.

    0

    마크 다운 헤더 규칙 내에서 이전 메모와의 조정이 있습니다. 제거하지만
    3. 모든 공간이 하이픈으로 변환됩니다 하이픈으로 변환되지
    1. 모든 텍스트가
    2. 모든 단어가 아닌 텍스트를 소문자로 변환한다 (예, 구두점, HTML)이되어
    4.Two 또는 더 많은 하이픈이 하나의
    으로 변환됩니다. 5. 동일한 ID를 가진 헤더가 이미 생성 된 경우 고유 한 증가 숫자가 추가됩니다 (1부터).
    따라서 SEND EMAIL TO DBA'S - is created like this: * [5. SEND EMAIL TO DBA'S] (# 5-send-email-to-dba-s).
    희망이 있으면 누구나 쉽게 찾을 수 있습니다.