Discussions
Dark mode support
We were thinking to migrate to Readme and because our previous system has dark mode support, we were thinking if this is planned.
Developers staring at night on a bright documentation is something very unpleasant.
Posted by Aditya over 2 years ago
Let customers download open api spec
The admin dashboard has a way to export the api to oas spec file
But it doesn't seem like there's a way for the public facing api spec page to download an oas json file
That would be useful for customers if they prefer exploring the api with tools like Postman etc
Posted by Michael De Razon over 3 years ago
Is there a way to expand or hide content?
In my organization's API guides, we sometimes need to list a lot (like, 30) API endpoints, which all are related to a specific functionality. Including such a list to a table or in the document body has a real negative impact on readability.
In our internal wiki (Confluence), I can create a table with an expand macro, so the user can toggle between viewing and hiding the list of endpoints.
Do you have any suggestions on how to work around this in ReadMe?
Posted by Katri Metsävuo about 2 years ago
3-level nested TOC - Possible?
Beyond the page and then a page nested under it, is it possible to create a third hierarchical level?
Something like this:
Page - Level 1
Nested Page - Level 2
Nested Page - Level 2
Further Nested Page - Level 3
Page - Level 1
Posted by Paula Stern about 3 years ago
Download a csv or zip file
Is there a way to embed a download link in the documentation?
Posted by Dustin Boswell about 2 years ago
Enum value used as example appears twice in combo box
Hello,
When declaring in my OpenAPI spec a field such as:
```
"carColor":{"type":"string","example":"WHITE","description":"Color of the car","enum":["WHITE","BLACK","BLUE"]}
```
... then the field appears in Readme with a combo box with the possible values: `WHITE`, `WHITE`, `BLACK`, `BLUE`. If I select the first `WHITE` value, it won't be included in the generated JSON in the right pane (it does work with the other values).
Is there a way to have this value appear only once, be included in the generated JSON and still keep this value as an example?
Thank you,
Eric
Posted by Eric T almost 3 years ago
Upload multiple images at once
Is there was a way to upload all of the images I need for my team's guides into ReadMe at once? In previous Markdown-based doc repos, I've seen things like an "attachments" folder, where you can upload all of the things you want to link to in your docs - is there any feature like that in ReadMe? I've also seen the suggestion in [this post](https://docs.readme.com/discuss/60ef30cc442bc901a01f3aaa) that we can host our images on a separate site like Imgur, but it would be much more convenient for my team if we were able to keep all of our images on ReadMe.
Thanks in advance!
Posted by Sarah Eberhardt over 2 years ago
Is there a way to add comments using Readme's markdown?
I'd like to add a comment to a topic in readme that internal users will be able to see, but that will not get picked up and published, such as:
..
internal RST comment
<!--- internal GitHub markdown comment --->
<!--internal HTML comment-->
Is that possible in a ReadMe file? I'm not seeing anything in the markdown reference, and would like to avoid trial and error if possible.
Posted by Alison about 3 years ago
Quick and easy way to copy paste into a table
Hi! Just wondering if there is an easy way to copy and paste tables from one document (Word, Spreadsheet) into ReadMe?
Posted by MJ almost 3 years ago
Post here or contact Support?
**Wonder what other customers are doing?**
Post here if you're looking for advice or best practices from fellow ReadMe customers!
**Have a problem right now that needs ReadMe attention?**
To report bugs or other issues with your ReadMe project, it's best to reach out to our Support team directly using the Intercom Messenger in the bottom right-hand corner.
**If you need emergency support**
Your project isn't loading, or you're getting 500 errors on mission critical pages? You can open the Intercom widget and type "ReadMe is down" or "getting a 500 error" and we'll be paged. Just include any relevant information about your project (URL, project name) and the error (dev console error, Cloudflare status code) and we'll take it from there!
**File a Feature Request**
Visit [feedback.readme.com](https://feedback.readme.com/tabs/4-candidate/submit-idea) to submit your idea, upvote existing requests, and see our product roadmap!
Posted by Ehsan Mafi over 3 years ago