Я хотел бы отформатировать описания Swagger API, чтобы они не были простыми абзацами текста. Предпочтительно, я хотел бы добавить к нему небольшую таблицу.
Я не нашел онлайн-ссылку на форматирование текста в описаниях Swagger. Если я запустил Редактор Swagger и откройте пример Instagram (File\Open Example\Instagram.yaml), я вижу первое описание в Файл yaml показывает некоторое форматирование, включая гиперссылку и ограничительную рамку:
[registered your client](http://instagram.com/developer/register/) it easy
to start requesting data from Instagram.
```
https://api.instagram.com/v1/media/popular?client_id=CLIENT-ID
```
Это выглядит как стандартный Markdown, но когда я добавляю уценку таблицы к описанию образцов, редактор представляет ошибку:
|Col1|Col2|
|------|------|
|1|2|
YAML Syntax Error
End of the stream or a document separator is expected at line 36, column
Какое форматирование позволяет Swagger 2.0? Я делаю что-то неправильно, чтобы сделать таблицу?