Abschriften interne Links nicht in BitBucket Arbeits README.md

Question

ich eine README.md Datei in einem BitBucket Projekt, das so etwas wie

## Table of Contents 

* [Document Organization](#document-organization) 

... 

## Document Organization 

geht Wenn ich die Links, um den Abschlag Vorschau im Browser mit Sublime Text öffnen Wechseln Sie im Inhaltsverzeichnis zu den entsprechenden Abschnitten, aber wenn ich die Datei in BitBucket hochlade, scheint die URL korrekt zu sein, springt aber nicht in den Abschnitt.

Das BitBucket-Repository ist privat, daher kann ich es nicht teilen.

Wie kann ich das beheben?

Answer 1

Ich würde die erzeugte HTML-Datei auf dem Anker-Tag überprüfen, von dem, was ich von bitbuckets Auto-IDs erinnern kann ich vermuten, dass Ihr Link mehr wie

* [Document Organization](#markdown-header-document-organization) 

Answer 2

aussehen muss hier ist ein Ausschnitt einer Tabelle von erzeugen Inhalt für Bitbucket-Readmes (oder andere Markdown-Dateien).

cat readme.md |\ 
grep "^#" |\ 
sed 's|^[ ]*||g' |\ 
awk -F, '\ 
BEGIN { 
}{ 
    basic_name=$1; 
    anchor=basic_name 
    basic_name_no_hash=basic_name 
    gsub(/^[#]* /,"",basic_name_no_hash) 
    gsub(/[ ]*$/,"",basic_name_no_hash) 
    subs_string=basic_name 
    subs = gsub(/#/,"",subs_string); 
    gsub(/^[#]+ /,"",anchor); 
    gsub(/ /,"-",anchor); 
    anchor = tolower(anchor); 
    {for (i=0;i<subs-1;i++) printf " " } 
    print "* [" basic_name_no_hash "](#markdown-header-" anchor ")"; 
} 
END { 
}' 

Answer 3

Dies kann ebenso gut tun.

Entsprechend dieser: https://confluence.atlassian.com/bitbucket/mark-up-comments-305037452.html unterstützt bitbucket die Erweiterung Inhaltsverzeichnis, die automatisch die Links und Anker basierend auf den Dokumentheadern generieren kann.

Die TOC-Erweiterung hier dokumentiert ist: https://pythonhosted.org/Markdown/extensions/toc.html

Fügen Sie den Text „[TOC]“ an den Anfang des Dokuments für sie erzeugt werden.