Как сделать ссылки на разделы одного и того же документа, используя Markdown, где заголовок заголовка - это предложение с пробелами?
Пока это работает
1. [Notifier system requirements](#requirements)
Это не работает
1. [Deployment steps](#steps to deployment)
Steps to deployment
а также requirements
названия заголовков / разделов в моем README.md
файл.
2 ответа
Решение
Посмотрите на цель визуализированного заголовка, наведя на него курсор мыши или проверив его с помощью devtools вашего браузера. Вы должны обнаружить, что цель для заголовка "Шаги к развертыванию" не steps to deployment
, скорее steps-to-deployment
,
Обновите вашу ссылку так, и она должна работать:
1. [Deployment steps](#steps-to-deployment)
Согласно этому фильтру (связан с github / markup), GitHub использует следующие шаги для преобразования текста в слаг:
- Преобразуйте все символы в строчные буквы ASCII.
- Уберите все знаки препинания, кроме пробелов и дефисов.
- Преобразуйте все пробелы в дефисы.
Поэтому ваша ссылка должна быть:
[Deployment steps](#steps-to-deployment)