Swagger operation paths must be escaped

Swagger2Markup / swagger2markup

A Swagger to AsciiDoc or Markdown converter to simplify the generation of an up-to-date RESTful API documentation by combining documentation that’s been hand-written with auto-generated API documentation.

Apache License 2.0

2.5k stars 383 forks source link

Swagger operation paths must be escaped #119

Open RobWin opened 8 years ago

RobWin commented 8 years ago

swagger json path: /reserved/{myparaminpath}/components

Current generated AsciiDoc : === GET /reserved/{myparaminpath}/components

This causes issues, because it clashes with Asciidoctor attributes.

escaped AsciiDoc:

=== GET /reserved/\{myparaminpath\}/components

Kabhal commented 8 years ago

the correct solution is heavy : having MDB escape input text depending on output markup and optionally introduce MDB::rawTextLine(text)