Files and symlinks support[a custom media type](#custom-media-types) for retrieving the raw content or rendered HTML (when supported).

Directories support[a custom media type](#custom-media-types) for retrieving the content as an object rather than an array of its entries.

Submodules do_not_ support custom media types.

All content types support[a custom media type](#custom-media-types) to ensure the content is returned in a consistent object format.

{{#tip}}

Use the`.raw` media type to retrieve the contents of the file.

[Directories](#get-contents) supportthefollowing custommedia type:

For markup files such as Markdown or AsciiDoc, you can retrievetherendered HTML using the`.html`media type. Markup languages are rendered to HTML using our open-source[Markup library](https://github.com/github/markup).

For markup files such as Markdown or AsciiDoc, you can retrieve the rendered HTML using the`.html` media type. Markup languages are rendered to HTML using our open-source[Markup library](https://github.com/github/markup).

Use the`.object` media type to retrieve the contents in a consistent object format regardless of the content type. For example, instead of an array of objects

for a directory, the response will be an object with an`entries` attribute containing the array of objects.

You can read more about the use of media types in the API[here](/v3/media/).