Как добавить разрыв строки в документацию Swashbuckle?

Question

Я создаю документацию для api, реализованной в Web Api 2, используя swagger/swashbuckle.

Единственными признанными тегами документации xml являются <summary>, <remarks> и <param>.
Это означает, что я не могу использовать тег <para> для форматирования текста в новых строках или параграфах, все создается как непрерывный длинный абзац в записи Notes Notes.

Есть ли способ сделать это?

Answer 1

Другим способ достижения является созданием пользовательского OperationFilter и использовать теги XML документации, как описан в:

https://github.com/domaindrivendev/Swashbuckle/issues/258

Надеется, что это помогает

Сэму

Answer 2

Я нашел, что вы можете просто добавить <br /> теги к комментариям для достижения этого.
Добавление:

/// <br /> 

вызовет разрыв строки в сгенерированной документации.