OpenAPI 3.0 Callback malformed rendering
See original GitHub issueDescribe the bug
OpenAPI 3.0 callback fields do not get rendered correctly in the .md output. There are a few issues:
- I think the main issue is that the
##heading is duplicated for each request, even if there’s only one request with a callback. This may be triggering the secondary issues. Please see the attached screenshot of Shins loading the .md file. - The API call is duplicated in the center column.
- The code block is rendered within the center column.
- - I have checked that my input document is valid OpenAPI 2.0/3.0.x or AsyncAPI 1.x
To Reproduce Steps to reproduce the behavior:
- For the input file, use the
callback-example.mdfrom the official OpenAPI repo’s 3.0 example spec: https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v3.0/callback-example.yaml - Command-line:
node widdershins callback-example.yaml -o callback-example.md
- Load
callback-example.mdfromshins. - See layout errors in screenshot.
Expected behavior I’d expect:
- To see a single entry in the TOC for
post__streams. - To see a single entry in the enter column for
post_stream. - To not see example code in the center column.
Screenshots

Versions:
- Node.js v10.11.0
- Widdershins 3.6.4 and master (https://github.com/Mermade/widdershins/commit/fc2f2d82ab7a75c2fbb2a30599ca8a1e90144495)
- Shins master (https://github.com/Mermade/shins/commit/59bcf6c7aa66dfb0016d52b24f01f866b70e40a1)
Issue Analytics
- State:
- Created 5 years ago
- Comments:6 (2 by maintainers)
Top Results From Across the Web
OpenAPI Specification - Version 3.0.3 - Swagger
The OpenAPI Specification defines a standard interface to RESTful APIs which allows both humans and computers to understand service capabilities without ...
Read more >OpenAPI Specification v3.0.3 | Introduction, Definitions, & More
Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the...
Read more >Issue in rendering Swagger OpenAPI v3 UI + Springboot project
The problem is localhost:8080/v3/api-docs/ responses "{"openapi":"3.0.1", "\info":{..." which is a String, NOT a valid JSON as expected. It ...
Read more >TS 129 501 - V17.6.0 - 5G ; 5G System; Principles and Guidelines ...
OpenAPI : "OpenAPI Specification Version 3.0.0", ... A complete callback URI for the "smContextStatusUri" has the following structure.
Read more >ForgeRock Access Management 6.5 > Development Guide
Serves an API descriptor that complies with the OpenAPI specification. ... The /json/authenticate endpoint supports callback mechanisms to perform complex ...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found

Thanks for digging further. I believe it was working when released, possibly the overrides css in shins is required.
Any update on this? also happy to test it out