Adding Content to Guru Cards

Guru’s Card editor enables Collection Owners and Authors to format content for clarity and readability. The editor supports Markdown, and allows embedding of images, files, videos, and more for rich, interactive documentation.

📘

Best Practices

For tips and tricks, see Best Practices: Cards

Adding and editing images

Uploading images

  1. Click the Image icon in the editor toolbar, or type / and select Image.
  2. Select the image from your local device using the file picker.
  3. The image will appear in the Card.

✍️

Note

During the final step of creating a Card, you can allow teammates to share attached images outside of Guru. This adds a globe icon to the image, though access to the full Card still requires Guru permissions.

Editing images

  • Resize: Drag the right edge of the image.
  • Rename: Click the image filename while in edit mode.
  • Replace: Use the refresh icon to upload a new image.
  • Delete: Click the trash can icon.
  • Download: Click the download icon (image may open in a new tab first).
  • Alt text: Click Alt Text, enter a description, and click Save.

Uploading and inserting files

  1. Click the File icon in the editor toolbar, or type / and select File.
  2. Choose a file from your local device.
  3. The uploaded file appears as a paperclip icon with a hyperlink.

✍️

Note

In the final step of Card creation, you can allow external file sharing via the globe icon.


Creating and editing tables

Inserting a table

  1. Click the Table icon in the toolbar, or type / and select Table.
  2. An empty table appears. Use Tab to move between cells.

Editing a table

  • Table options: Use the menu to enable header fill, download as CSV, or delete.
  • Column options: Click at the top of a column to add or remove columns.
  • Row options: Click at the end of a row to add or remove rows.
  • Resize: Drag lines between columns to adjust width.

Using a Table of Contents

Creating a table of contents

  1. Apply heading formatting (H1, H2, or H3).
  2. A table of contents appears on the left as headings are added.

Viewing the table of contents

  • Readers can toggle the table of contents from the left-hand side of the Card.

Adding callouts

  1. Click the Callouts icon or type / and select Callouts.
  2. Choose a banner color and add your highlighted text.

Adding collapsible sections

  1. Click the Collapsible Section icon or type / and select Collapsible Section.
  2. Add a title (always visible), and body text (collapsible by default).

Using Markdown blocks

  1. Click the Markdown icon or type / and select Markdown.
  2. Enter your Markdown-formatted text.
  3. Use the Preview icon to see the output.
  4. Click the Edit icon to return or Delete to remove the block.

Linking Cards, Profiles, and External Content

Linking to a Guru Card

  1. Click the Guru Card icon or type / and select Guru Card.
  2. Search for and select a Card to link.
  3. A green G icon appears beside successfully linked text.

Viewing incoming links to a Card

  1. Open the Card and click the menu > Card details.
  2. Click the Cards that link to this Card tab.
  3. View linked Cards (titles are hidden if you lack access). If none exist, a No Links message appears.

❗️

Important

Before renaming or archiving a Card, check how many Cards link to it to avoid breaking references.

What happens if a user lacks access?

If a user clicks a link to a Card they cannot access, they'll see a message indicating restricted access. They must contact a workspace admin to request permission.


Adding code blocks

  1. Click the Code Block icon or type / and select Code Block.
  2. Paste or type your code into the block.
  3. Choose a language from the dropdown at the top-right.
  4. Use Copy Code or Delete as needed.

In the published Card, the language and a Copy Code button are visible at the top-right of the block.