スウェーガーモデルの説明でマークダウンを使用するにはどうすればよいですか？

Question

Swaggerのモデルアイテムに追加情報を追加しようとしています。ドキュメントには、GFM構文を説明フィールドで使用できると記載されていますが、これはすべての場所で機能していません。ここで

は、問題の最小限のダミー例です。

swagger: '2.0' 
info: 
    title: Example API 
    description: (1) This is the API description containing some *rich* **text** 
    version: "1.0.0" 
paths: 
    /products: 
    get: 
     summary: Product Types 
     description: (2) This is the path description also containing some *rich* **text** 

     responses: 
     200: 
      description: (3) This is a response description also containing some *rich* **text** 
      schema: 
      type: array 
      items: 
       $ref: '#/definitions/Product' 

definitions: 
    Product: 
    description: (4) This is a model description where *rich* **text** does not work 
    type: object 
    properties: 
     product_id: 
     type: string 
     description: (5) This is a field description where *rich* **text** does not work 

schema object documentationは、私は（4）とマークされた場所でのMarkdownを使用することができるはずと言う超えるがありません場所について何か言いなさい（5）。

モデルセクションの2か所のいずれかにMarkdownを追加します。これをどのように機能させることができますか？

Answer 1

スワッガーエディタは、モデルの説明でMarkdownをサポートしていません。 https://github.com/swagger-api/swagger-editor/issues/682から：

JSONスキーマオブジェクトのレンダリングでは、Markdownをサポートしていないjson-schema-view-js libを使用しています。 Swagger Editorはこのlibの動作を変更することはできません。この動作はlibに追加するのに共通するものではありません。

この機能が必要な場合は、swagger-editorおよび/またはjson-schema-view-jsをフォークし、自分自身を修正/機能を実装し、プルリクエストを提出することができます。