Skip to main content

Using Markdown

James
  • Updated

    Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid HTML.

    Sketchfab supports Markdown in model descriptions and Annotations.

    Here's an example.

    Primary Markdown Syntax

    These are the features most relevant to Sketchfab models.

    Images

    ![](https://website.com/path/to/img.jpg)

    Will produce

    Sketchfab logo

    Optionally, you can add alt text and a title (important for SEO and accessibility), like this:

    ![Alt text](https://website.com/path/to/img.jpg "Title")
    This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

This is [an example][id] reference-style link.

Other stuff goes here...

[id]: http://example.com/  "Optional Title Here"

    Will produce an example link.

    You can make an image that is a link by combining the link code with the image code. Use the image code instead of text:

    [![](https://website.com/path/to/img.jpg)](http://example.com)

    Will produce

    Sketchfab logo

    Videos

    While you can link to a video hosted elsewhere (as described above), you cannot produce a video within your model's description or Annotations by using Markdown.

    If you'd like to build a more customized experience with features like embedded videos, it's possible to do on your own website using the Viewer API. 

    Emphasis

    *single asterisks*
_single underscores_

    Will produce italic text

    **double asterisks**
__double underscores__

    Will produce bold text

    Titles

    This is an H1
=============

This is an H2
-------------

# This is an H1

## This is an H2

###### This is an H6

    Lists

    Unordered

    * Red
* Green
+ Blue
- Yellow

    Will produce

    • Red
    • Green
    • Blue
    • Yellow

    Ordered

    1. First item
2. Second item
1. Third item
(The number before the period has no effect on the actual order, it just needs to be a number)

    Will produce

    1. First item
    2. Second item
    3. Third item

    Other Markdown Syntax

    A lot of other Markdown features are supported, but they may not be very useful in the context of Sketchfab models. See this documentation for details:

    It's also supported in Help Center comments, although the implementation may not be identical.

    Related articles

    Comments

    68 comments

    Date Votes
    • virtualsweden

      I guess markdown is not working on Collection description? OR am I missing something?

      0
    • James

      Not at the moment, but it's something we're thinking about adding.

      0
    • virtualsweden

      Can it be ready by Thursday? ;)

      0
    • James

      Nope ;)

      0
    • toppan_equator

      I want an image in the title of the annotation? but i can't do . Please help me

       

      0
    • James

      Hi toppan_equator - I'm afraid that Markdown is not supported in annotation titles, only descriptions.

      0
    • hawkins3DIB

      Hello Sketchfab, have we had any progress yet on changing the size of the images in annotations?

      0
    • James

      Hello,

      I'm afraid that changing the size of images in annotations is not planned.

      If you need that level of customization, I would recommend looking into the Viewer API instead. You could hide the "default" annotation tooltips and display whatever content you like on top of the viewer.

      https://sketchfab.com/developers/viewer/examples?sample=User%20Annotation

      0

    Please sign in to leave a comment.