Вопрос или проблема
Я работаю над базой знаний, размещенной на GitHub. Я могу связывать документы, используя только имя файла. Например: Совместимость в !Боковой панель с [Совместимость](Совместимость). Я также могу связывать конкретные заголовки из других файлов так: [Совместимость](Совместимость#Заголовки), что открывает Совместимость.md @ ## Заголовки. Однако, если заголовок содержит пробелы, я не могу, похоже, связать эти заголовки… Возможно ли создать гиперссылку на заголовок, содержащий пробелы в Markdown? Я предпочел бы сохранить пробелы, которые у меня уже есть во многих заголовках.
“Возможно ли создать гиперссылку на заголовок, содержащий пробелы в Markdown?”
Да! Просто используйте HTML-сущность для пробела (т.е. %20) вместо пробела в ссылке. Например, если вы хотите связать с Долгие заголовки, вместо этого:
[Совместимость](Совместимость#Долгие Заголовки)
Вы сделаете вот так:
[Совместимость](Совместимость#Долгие%20Заголовки)
Просто убедитесь, что заголовок действительно имеет id=, который установлен на Долгие Заголовки.
Markdown не знает, что вы ссылаетесь на заголовок Markdown — все, что он знает, это то, что вы ссылаетесь на какую-то другую HTML-страницу. Это означает, что важны не сами текст заголовка, а сгенерированные HTML-теги.
Рендереры Markdown обычно заменяют пробелы тире при создании анкор. Заголовок, такой как “Системные требования”, обычно будет иметь анкор #system-requirements. Кроме того, большинство специальных символов, как правило, удаляются.
Если целевая страница находится на GitHub, вы можете использовать значок ‘ссылка’, который появляется при наведении на заголовок, чтобы увидеть, куда он ссылается (он ссылается на себя, и его цель — дать вам возможность скопировать ссылку на заголовок). Щелкните правой кнопкой мыши, выберите “Скопировать адрес ссылки”, вставьте результат в свой документ и обрежьте ненужные части.
В большинстве других случаев (т.е. не на GitHub, который использует продвинутый JavaScript для обработки #фрагментных ссылок), вы можете щелкнуть правой кнопкой мыши на заголовке и использовать опцию “Проверить” в браузере, чтобы увидеть, какой <h2 id= или <a name= был сгенерирован. Например, может быть <h2 id="sysreq">Системные требования</h2>, который будет связан как #sysreq.
Ответ или решение
Да, вы можете создать гиперссылку на заголовок, содержащий пробелы, в Markdown, но для этого есть несколько нюансов, которые нужно учитывать.
-
Использование HTML-кодировки: Если вы хотите использовать имеющиеся пробелы в заголовках, вы можете заменить пробелы на HTML-кодировку
%20. Например, если ваш заголовок называется "Долгие Названия", ссылка должна выглядеть так:[СCompatibilidad](Compatibility#Долгие%20Названия) -
Проверка сгенерированного идентификатора: Markdown не знает о заголовках, а только о сгенерированных HTML-страницах. Обычно рендереры Markdown заменяют пробелы на дефисы в сгенерированных идентификаторах заголовков. Например, заголовок "Системные Требования" может быть представлен как
#sistemnye-trebovaniya. Чтобы именно так это выглядело, вы можете:- Перейти на боевую версию вашего документа на GitHub и навести курсор мыши на заголовок. Появится иконка ссылки, по которой вы можете щелкнуть правой кнопкой мыши и выбрать "Копировать ссылку". Это даст вам точный идентификатор, которому вы можете следовать, например:
#sistemnye-trebovaniya.
- Перейти на боевую версию вашего документа на GitHub и навести курсор мыши на заголовок. Появится иконка ссылки, по которой вы можете щелкнуть правой кнопкой мыши и выбрать "Копировать ссылку". Это даст вам точный идентификатор, которому вы можете следовать, например:
-
Использование инструмента разработчика: Если вы работаете не на GitHub и хотите проверить, как будет представлено ваше заглавие, вы можете использовать инструменты разработчика вашего браузера. Щелкните правой кнопкой мыши на заголовок и выберите "Просмотреть код элемента" или "Инспектор". Таким образом, вы сможете увидеть сгенерированный идентификатор, например:
<h2 id="sistemnye-trebovaniya">Системные Требования</h2>В этом случае вы можете ссылаться на этот заголовок, используя идентификатор без пробелов:
[Системные Требования](ваш-документ#sistemnye-trebovaniya)
С учетом вышесказанного, когда вы хотите создать ссылки на заголовки с пробелами, всегда лучше проверять сгенерированные идентификаторы, так как это наиболее надежный способ убедиться, что ваша гиперссылка будет работать.