Skip to content
Skip to main contentAgent-Native Hackathon: $10K in prizes. Ends Nov 9.Start Building
CONTACT SALESSTART BUILDING

Import Markdown in the Visual Editor

In beta

Markdown is a type of shorthand for writing documents that browsers can turn into HTML. Markdown is often the language of choice for README files on GitHub, blog posts, and documentation, to name a few. Markdown's appeal lies in its speed of use and minimal syntax.

With the Import Markdown feature, you can import or write Markdown right inside of Builder Content. When you import your Markdown, supported content becomes standard Builder Content elements that you can edit right in the Visual Editor. Builder converts headings, paragraphs, block quotes, lists, links, bold and italic text, inline code, code blocks, and images. Other Markdown syntax, such as tables, isn't imported.

An intro to Markdown

Markdown is capable of many of the same things as HTML. If you're new to Markdown and would like to use it, check out Basic writing and formatting syntax in the GitHub documentation.

The following is an example of basic Markdown that a person writes before a browser turns it into HTML. The syntax is minimal compared to full HTML:

# I am an h1 heading I am a paragraph with a [link to Builder.io](https://www.builder.io/). ## I am an h2 heading - list item - list item - list item And here's a picture: ![Alt text here: this is our logo](https://www.your-site.com/logo.png) ``` I'm a code block! ```

Add Markdown content

In the Visual Editor:

  1. Press Cmd + k (Mac) or Ctrl + k (Windows).
  2. Select Import Markdown (beta).
  3. Type or paste in your Markdown.
  4. Click the Import button.

The following video demonstrates these steps.

Add Markdown to existing content

In the Visual Editor:

  1. Click the block just before where you'd like to add content.
  2. Press Cmd + k (Mac) or Ctrl + k (Windows).
  3. Select Import Markdown (beta).
  4. Type or paste in your Markdown.
  5. Click the Import button.

The following video demonstrates these steps.

Import a Markdown file

In the Visual Editor:

  1. Press Cmd + k (Mac) or Ctrl + k (Windows).
  2. Select Import Markdown (beta).
  3. Click Upload a file and choose a Markdown file.
  4. Click the Import button.

If you have an embed in your Markdown, add it to Builder Content by dragging in an Embed block from the Insert tab and adding the embed link to the block's Edit dialog.

The following video demonstrates these steps.

What's next

The Command Palette serves as a shortcut for many Builder features and can help you speed up your Builder workflow. To learn more, visit Get around Builder Content with the Command Palette.

Was this article helpful?