Skip to main content
Amber stores your entire workspace as standard markdown (.md) files with open, portable formatting. This means your writing is:
  • Portable: Open your files in any text editor or markdown app
  • Compatible: Use your files with Google Docs, Microsoft Word, Notion, and hundreds of other tools
  • Future-proof: Markdown is a universal format that won’t become obsolete
  • Collaborative: Share files with writers using different tools

​
How Your Workspace Is Organized

All your Amber content is stored in a simple file structure: 
My Novel/
├── Chapter 1.md                # Sections stored as markdown
├── Chapter 2.md
├── Notes/
│   ├── Characters.md           # Notes as markdown
│   └── Plot Points.md
├── Sources/
│   ├── Research.md             # Sources as markdown
│   └── Inspiration.md
├── amber.md                    # AI steering instructions
└── .amber/
    ├── metadata.json           # Workspace metadata
    ├── chat-history.json       # Chat conversations
    └── embeddings.db           # Vector embeddings for AI
Every file you write is saved as clean, readable markdown. No proprietary formats. No lock-in.

​
File Types in Your Workspace

​
Markdown Files (.md)

Your actual writing content:
  • Sections: Chapters, scenes, parts of your story
  • Notes: Quick reference material and ideas
  • Sources: Detailed character backgrounds, world-building, research
All stored as standard markdown—human-readable and editable everywhere.

​
JSON Files (.json)

Structured metadata:
  • Chat history: Full conversation history with AI
  • Metadata: Workspace structure and settings

​
Vector Embeddings (.amber/embeddings.db)

Local database for smart AI context:
  • Processed locally on your device
  • Enables intelligent context selection
  • Synced via iCloud for fast AI on all devices

​
Using Your Files Everywhere

Since Amber stores everything as markdown, you can:
  • Edit in other editors: VS Code, Sublime, iA Writer, Apple Notes, etc.
  • Use with other tools: Import to Google Docs, Word, Notion, Obsidian
  • Version control with Git: Full version history and collaboration
  • Open anywhere: Markdown is universally supported

​
Importing Amber Files to Other Platforms

​
Google Docs

1

Locate your markdown file

Open Finder and navigate to your Amber workspace folder. Find the .md file you want to import.
2

Copy the markdown content

Right-click the .md file → Open With → TextEdit (or your preferred editor) Select all text (⌘A) and copy
3

Open Google Docs

Go to docs.google.com and create a new document
4

Paste as plain text

Use Edit → Paste special → Paste without formatting (⌘ + Shift + V) This preserves your markdown formatting
5

Format in Google Docs

Google Docs will recognize markdown headers (#, ##) and format them automatically Manually fix any formatting that needs adjustment

​
Microsoft Word

1

Open your markdown file

Find your .md file in Amber workspace Right-click → Open With → Word
2

Word opens with markdown

Word recognizes markdown syntax and auto-formats:
  • # Header becomes Heading 1
  • **bold** becomes bold
  • *italic* becomes italic
3

Review and refine

Check that formatting came through correctly Make any adjustments needed for your document style
4

Save in Word format

Save as .docx or .doc as needed
Word is the easiest platform for Amber markdown—it handles the conversion automatically.

​
Notion

1

Prepare your markdown file

Open your .md file in a text editor Copy the markdown content
2

Create Notion page

Go to Notion and create a new page or database
3

Paste into Notion

Click into the page content area Paste your markdown (⌘V)
4

Notion auto-formats

Notion recognizes:
  • Markdown headers (#, ##, etc.)
  • Bold and italic
  • Lists and numbering
  • Code blocks and inline code
5

Fine-tune if needed

Notion handles most markdown well Adjust any formatting for Notion’s style
For complex documents: If your markdown has advanced formatting or custom elements, you may need to make minor adjustments in the target platform.

​
Syncing Across Your Devices

All your markdown files automatically sync via iCloud: On your Mac:
  • Auto-save writes to markdown files every few minutes
  • iCloud detects changes and uploads
On other devices:
  • iPad and iPhone can access your workspace via iCloud Drive
  • Third-party markdown apps can open the files directly
On different Macs:
  • Files sync automatically between all logged-in Macs
  • Changes appear within seconds
Learn more about storage and sync →

​
Version Control with Git

Your markdown files are Git-compatible for professional version control:
1

Initialize Git

cd "Your Amber Workspace"
git init
2

Commit your work

git add .
git commit -m "Complete Chapter 3"
3

Push to GitHub

git remote add origin https://github.com/yourname/project
git push -u origin main
Perfect for:
  • Tracking changes over time
  • Collaborating with other writers
  • Backing up your work
  • Experimenting with branches
Learn more about Git integration →

​
Coming Soon

Fountain Screenplay Support
  • Currently being rebuilt from scratch
  • Returning in a future release
  • Check our roadmap for updates
Direct Export
  • Export to PDF, Word, Google Docs
  • Currently on roadmap
  • For now, use the import guides above

​
FAQ

Can I edit my markdown files in other editors? Yes! Your .md files are standard markdown. Edit them in VS Code, iA Writer, Obsidian, or any text editor. Changes sync back to Amber via iCloud. Will changes made in other editors appear in Amber? Yes. Amber monitors your files for changes and updates automatically. Edit in your favorite editor, see changes in Amber. Are my files locked into Amber? No. You own your markdown files. Copy them anywhere, use them with any tool. Amber is a workspace, not a lock-in. Can I share my markdown files with non-Amber users? Yes. Your files are standard markdown—anyone can open them in any text editor or markdown app. They don’t need Amber.