Проблема с уценкой докси с амперсандом в ссылках

Question

Когда я создаю сайт maven с помощью (doxia-module-markdown)[http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-markdown] и файл.md содержит ссылки с амперсандами, в результате в сообщении об ошибке. example.md:

# Getting Started

## Now

1. goto [google] (https://www.google.com/?gws_rd=cr&q=test+site:com)
2. or goto <https://www.google.com/?gws_rd=cr&q=test+site:com>

Сообщение об ошибке:[ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.3:site (default-site) on project test: Error during page generation: Error parsing 'xxx\projects\test\src\site\markdown\not_working.md': line [3] Error parsing the model: entity reference name can not contain character =' (position: TEXT seen ...<a href="https://www.google.com/?gws_rd=cr&q=... @3:57) -> [Help 1]

Ошибка исчезает, как только я удаляю амперсанд.

Answer 1

Попробуйте заменить свои амперсанды &

Похоже, что строки анализируются как часть maven XML, и для того, чтобы это работало, вам нужно экранировать &, <,>и тому подобное.