Markdown liens internes ne fonctionnent pas dans BitBucket README.md

Question

Je dispose d'un fichier README.md dans un projet qui va BitBucket quelque chose comme

## Table of Contents 

* [Document Organization](#document-organization) 

... 

## Document Organization 

Quand j'ouvre l'aperçu Markdown dans le navigateur avec Sublime Text les liens Dans la table des matières, accédez aux sections appropriées, mais lorsque je télécharge le fichier sur BitBucket, l'URL semble correcte, mais elle ne passe pas à la section.

Le référentiel BitBucket est privé, donc je ne peux pas le partager.

Comment puis-je résoudre ce problème?

Answer 1

je vérifier le code HTML généré sur l'étiquette d'ancrage, de ce que je me souviens d'auto-ids de bitbuckets Je soupçonne que votre lien doit ressembler davantage à

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

Answer 2

Voici un extrait pour générer un tableau de Contenu pour readmes Bitbucket (ou autres fichiers markdown).

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

Cela peut également faire l'affaire.

Selon ceci: https://confluence.atlassian.com/bitbucket/mark-up-comments-305037452.html, bitbucket prend en charge la table des matières extension qui peut générer automatiquement des liens et points d'ancrage basés sur les en-têtes de documents.

L'extension TOC est documenté ici: https://pythonhosted.org/Markdown/extensions/toc.html

Ajouter le texte « [TOC] » au début du document pour qu'il soit généré.