Для того чтобы в файле markdown перейти к заголовку с текстом в текущем документе или другому файлу с определенным текстом. Пишется такая же ссылка, как и обычно в markdown, только с той разницей, что через #
указывается заголовок под которым находится необходимый текст.
Ссылки в файле .md пишутся следующим образом
В квадратные скобки заключается текст, который будет обозначен, как ссылка. Далее в круглых скобках пишется адрес (путь), куда будет осуществлен переход. И для перехода к заголовку, который является своеобразным якорем, пишется знак #
решетка и сам заголовок все маленькими буквами, пробелы заменяются тире -
[текст ссылки](/путь/адрес/к-файлу/#заголовок)
В примерах будет все горазда понятнее.
Примеры внутренних ссылок markdown
Текст в другом файле
[Передача управления доменом](/category/site/freenom-free-domain/#делегирование-домена)
В данном примере произойдет переход на пост (файл) freenom-free-domain
к тексту под заголовком Делегирование домена
. Выглядеть ссылка будет так :
[Русский язык](/category/site/static-website-with-hugo-debian/#русский-язык-в-visual-studio-code)
В этом примере смесь латиницы и кириллицы, главное, чтобы после решетки #
было точное название заголовка к которому ссылаемся. Получится такая ссылка:
Текст в текущем документе (посте)
[Ссылка внутри текущего файла](#ссылки-в-файле-md-пишутся-следующим-образом)
В таком случае переход будет к заголовку Ссылки в файле .md пишутся следующим образом
Всевозможные знаки удалить остальное Hugo сам допишет путь. По сути такие переходы это то же самое, как сделано Оглавление
Помощь редактора кода в вставке внутренних ссылок
Но проще всего делать внутренние ссылки, когда пишем в Visual Studio Code. Он сам предложит на выбор нужный заголовок
При написании ссылки в редакторе нажав слэш /
выпадет контекстное меню, при помощи которого выбрать месторасположение файла.
Стереть расширение файла .md
и ссылка будет работать.
Если в конце строки поставить #
выпадет контекстное меню со всеми заголовками в этом файле и таким образом можно сослаться на нужную часть в файле markdown.
Ещё примеры
[Ссылка внутри текущего файла](#ссылки-в-файле-md-пишутся-следующим-образом)
[Еще пример ссылки](/category/site/static-website-with-hugo-debian/#обновить-тему-hugo)
Комментарии