Discussions
How to make an example visible in multiple lines
Hello
I have this code snippet written in yaml.
I export it to readme via the CLI commande
![](https://files.readme.io/9b1529c-image.png)
In readme, it displays with only one line, which is not convenient for our customers
![](https://files.readme.io/aa28ab5-image.png)
How do i make my example visible in multiple lines ?
Thank you
Posted by null about 1 month ago
Can I add a table of contents on a guide page?
Can I add a table of contents on guide page that includes all pages under its parentdoc?
Posted by Netography Service Account about 1 month ago
Where do images live?
I have some images in a page and want to use them somewhere else. How do I find them and reuse them?
Posted by Roger Kirkham about 2 months ago
Multiple Security Schemes not showing up when uploading Swagger or Open API Spec
I'm trialing Readme for potentially utilizing for our developer documentation and dev portal. I have attempted to upload several different versions of my spec that have two different values being passed in as headers. However when I go to the portal it makes me select one or the other but doesn't allow me to pass both which is required.
<br />
```
token:
type: "apiKey"
name: "token"
in: "header"
api_key:
type: "apiKey"
name: "x-api-key"
in: "header"
```
If I view the same spec in swagger editor I see below and it lets me pass both.
![](https://files.readme.io/356017f-image.png)
How would I accomplish this in readme?
Posted by null 2 months ago
application/pdf API response content-type
We have an API which responses with PDF binary data using content-type application/pdf and content-disposition: inline;
readme.io is displaying the resulting binary as text within the response panel.
How do we improve this behaviour to either displaying the PDF inline in the response panel (like Postman or Insomnia would) or triggering a browser file download?
Posted by Alexander Ali 2 months ago
External Links not working
Hi
In our guide, we created several page of type "external link". They have worked as expected, but today I realize that they are not working.
You can see several of these links on this [page](https://readme.anytrack.io/docs/page-with-external-links).
Is this a known bug and is there an ETA for a fix?
Posted by laurent malka 2 months ago
Multiversion api spec file
Hey Team,
I need assistance with implementing a try out feature for an API spec file that contains two versions of a project. I would like the try out feature to be available in separate links for version v1 and version v2. However, currently, the version parameters and headers are being combined into one link instead of being segregated.
I have provided a sample spec file with multiple versions for your reference. Can you please help me resolve this issue?
Thank you.
<https://drive.google.com/file/d/1Jvzlm36QlRd_Wn7B0bIOISOlQjiSaF99/view?usp=sharing>
<https://drive.google.com/file/d/1Jvzlm36QlRd_Wn7B0bIOISOlQjiSaF99/view>
Posted by Gaurav Ajmera 3 months ago
Does the Owlbot/Ask AI understand emoji in tables?
It seems like, in a table about compatibilities, can it correctly parse something like the following to provide answers:
_[header row]_. _Capability Y_ \|\| _Capability Z_
- Software A: ✅ || ❌
- Software B: ❌ || ✅
Would using Git-style emoji shortcodes work better (e.g. :check-mark:) or an image or icon with alt-text?
Posted by null 3 months ago
How to document response parameters in detail
Hi, I want to document response parameters like it is done on this page:
<https://docs.readme.com/main/reference/updatedoc>
including a definition and example values for each. I cannot find out how to do this. Can you give an advice please? Thank you!
Posted by Yulia Rönsch 3 months ago
How to document a custom method
HI! We have custom methods (e.g., `RELOAD`). What should I do to be able to select it in the dropdown when I document a new endpoint? Where to configure it? Thanks a lot!
Posted by Yulia Rönsch 3 months ago