Import DESIGN.md files and share them with others

Goal

Bring existing DESIGN.md files into Figma, and give your documents to teammates or to a coding tool.

Before you start

• design.md creator open.

Steps

1. Drop the file Drag a DESIGN.md file from your computer onto the plugin window. "Import DESIGN.md file" appears; let go to add it to your library under its file name.
2. Handle duplicates If a document with the same name exists, choose Keep current, Use merged or Save as copy. The window shows Current, Incoming and Merged side by side.
3. Check the result A message sums it up, for example "Drop result: 2 imported, 0 merged, 0 discarded."
4. Download a document Open the Design system panel from the sidebar, open the theme’s menu and download its DESIGN.md as a .md file.
5. Share it Send the .md file to your teammates to drop into their own design.md creator, or add it to your code repository.

Tips

• Dropping a file while a document is open asks whether to merge it into that document.

Result

Your DESIGN.md files in the library, and copies you can hand to people and tools.

If something goes wrong

• "No valid DESIGN.md content found in dropped files." The file is not recognised as a DESIGN.md. Use a .md file with "design" in its name, or one with a name: or colors: line or a ## Colors heading.

Related guides

• CREATE A DESIGN.MD
  Create a DESIGN.md file from your Figma design Click + New and start from your selection, the current page, your variables, an empty scaffold or a built-in example, then edit and save it.
  →
• ASSIGN TO FRAMES
  Assign a DESIGN.md to frames and recolor them Save the document, select frames, and click Assign. The layers are linked to the DESIGN.md and take on its palette; Reset assignment brings the old colors back.
  →