Scryve. Learn

All guides / Writing

Embeds, tables and code

Put a video, a song, a post, a table, a block of code or a callout (a note, a tip or a warning) inside your article.

In short#

An embed shows a playable or live item from another site inside your article. You add it from a pasted link. This page also covers tables, code blocks and callouts. Anyone who can write can use all of them, in the Write page and the Edit page.

There are three ways:

  1. Paste a supported link into the body.
  2. Type "/" and choose Embed. A box titled Embed Media opens ("Paste a URL from YouTube, Vimeo, Spotify, SoundCloud, X/Twitter, CodePen, or GitHub Gist."). Paste the link and press Embed.
  3. Press + at the left of a line and choose Embed. Paste the link in the box and confirm with the tick. The X closes the box. A link that cannot be embedded keeps the box open and says "This link is not supported."

After an embed goes in, the cursor sits on a new line under it, so you can keep typing, and a second embed is added under the first. For a YouTube video the cursor comes back to the text once the player has loaded.

These sites work:

SiteLinks that work
YouTubeyoutube.com/watch?v=, youtu.be/, youtube.com/embed/, youtube.com/v/ and youtube.com/shorts/, with or without www
X or Twittertwitter.com or x.com post links like /name/status/123, also with the mobile. prefix
Vimeovimeo.com/123 and player.vimeo.com/video/123
Spotifyopen.spotify.com links for a track, album, playlist, episode or show
SoundCloudsoundcloud.com and on.soundcloud.com
CodePencodepen.io/name/pen/id
GitHub Gistgist.github.com/name/id

A YouTube link with something before v= (for example watch?feature=shared&v=...), a playlist, a channel or a live link is accepted by the editor, but the article page shows no player for it. Copy the short youtu.be link instead.

These do not match and stay plain links: m.youtube.com, music.youtube.com, Spotify links with a country part such as open.spotify.com/intl-pt/track/..., Vimeo channel links and CodePen /full/ links. Other sites, such as Instagram, Facebook or Reddit, cannot be embedded from the editor.

If the text you paste starts with a supported link, the whole paste becomes an embed. Any text after the link in that paste is dropped. To keep a plain link to one of these sites, type your own words, select them and use the link icon in the floating bar (see The editor).

Tables#

  1. Type "/" and choose Table, or press + and choose Table. A 3 by 3 table with a header row appears.
  2. Put the cursor in a cell. A bar with five icons appears above the table (and stays on screen as you scroll a long table). Rest the pointer on one to see its name: Add Row After, Add Column After, Delete Row, Delete Column and Delete Table. Each is at least 44 px wide, so it can be tapped. With text selected in a cell, the floating bar shows the same five icons after the link icon.

A table that is wider than the text column slides sideways inside its own box, in the editor and on the article page; the page itself does not move. If you paste a range from a spreadsheet or a web page, its widths are dropped, the columns share the column, and a first row with no header becomes the header row.

Columns can be dragged to resize them. Dragged column widths and merged cells are not kept when the article is saved.

Code blocks#

Start a code block in any of these ways:

  • type "/" and choose Code Block
  • press + and choose Code
  • select text and press the Code Block icon in the floating bar
  • type three backticks, then a space or Enter

Inside the block, a picker sets the language: Auto, None, or one of 31 languages (Bash, C, CSS, C++, C#, Dart, Diff, Go, GraphQL, "TOML, INI" (one entry), Java, JavaScript, JSON, Kotlin, Lua, Makefile, Markdown, Objective-C, Perl, PHP, Python, R, Ruby, Rust, SCSS, Shell, SQL, Swift, TypeScript, XML, YAML). The language is saved with the block. It does not colour the code. The block is dark in both themes, as on the article page, with the language picker and the copy button inside its top edge. The copy button shows when the pointer is over the block or when it has keyboard focus, and always on a touch screen. Readers get a copy button on the article page the same way. The Tab key inserts two spaces (on selected lines it indents each one), and Shift + Tab takes up to two spaces off the line. Neither leaves the editor.

Callouts#

A callout is a box that sets a note, a tip or a warning apart from the text. It has a line at the left, an icon and a word (Note, Tip or Warning), so the kind can be told without the colour. It holds paragraphs, lists, links, bold, italic and inline code. It cannot hold a table, a picture, an embed, a heading, a quote, a code block or another callout, and it cannot stand inside a list item, a quote or a table cell.

Add one in any of these ways:

  • Type "/" and choose Note, Tip or Warning, under Callouts. Typing the English or the Portuguese name finds it.
  • Press + and choose Callout. It adds a note; change the kind afterwards.
  • Select text, open Turn into in the floating bar and choose Note, Tip or Warning. The block you are in goes into the callout, and a line in a list item leaves the list.
  • Type > and then [!NOTE] , [!TIP] or [!WARNING] (Markdown, as on GitHub). Pasting a quote that opens with one of those markers alone on its first line gives a callout too, and a callout you copy from the editor leaves written the same way.
  • Press Ctrl or Cmd + Alt + N on a line. With the cursor already in a callout, the same keys change its kind: Note, then Tip, then Warning, then Note again. The keys are in the shortcuts list.

To change the kind, press the small button at the top right of the callout. It shows the icon of the kind it has now and opens a list of the three. From the keyboard, with the cursor in the callout, press Tab to reach its button (only the button of the callout the cursor is in is on the Tab path), Enter to open the list, Tab to move along it and Enter to choose. Focus goes back to the button, and Shift + Tab returns to the text. The button says, for example, "Change the callout type (now Tip)", and the block is named by its kind, Note, Tip or Warning, for a screen reader. On a phone the button and each choice are at least 44 px.

To leave a callout, press Enter twice on an empty last line: the cursor moves to a new line under it. To take the box off, press Backspace at the very start of the callout; the text stays.

Readers see the same box on the article page, in the light and the dark theme. The word is in the language of the article (English, or Portuguese for an article set to Portuguese; an article in another language shows the English word). The permanent copy of a sealed article draws it as a small bordered box with the word as text, always in English. The article and its seal are not changed by this. A page that does not draw the box, such as a plain HTML reader, shows the paragraphs one after the other.

Saving keeps a callout as a box with its kind (note, tip or warning) and nothing else on it. Changing the kind of a callout in a sealed article is an edit like any other and removes the seal; see Edit and delete.

Good to know#

  • Video and audio tags pasted from other pages are removed when the article is saved. Use a supported link instead.
  • The permanent copy of a sealed article is a plain page with no players. There each embed is a line with a link to the video, post, track, pen or gist, and a picture's caption shows under it. The article itself, and its seal, are not changed by this.
  • Anything the editor drops when you save disappears without a message. See "What is kept when you save" on The editor.

If something goes wrong#

  • The "/" box says "Unsupported URL. Please use YouTube, Vimeo, Spotify, SoundCloud, X/Twitter, CodePen, or GitHub Gist links." The link is not one of the forms in the table. Copy the link again from the item's own page.
  • The "+" box says "This link is not supported." The link is not one of the forms in the table. Copy the link again from the item's own page.
  • The paste gave an embed and lost your words. See "Pasting a link" above.

Checked: 2026-11-19