Elephant.md for VS Code
Publish, push, pull, and share markdown documents on elephant.md — directly from your editor.
Works with VS Code, Cursor, and Windsurf.
Features
- Publish & push markdown documents with a single command
- Auto-push on save — tracked files sync automatically with hash-based change detection
- Pull & install documents and AI skills into your workspace
- Search & discover trending documents from the community
- Ephemeral share links — timed or view-once (burn-after-reading)
- MCP server configuration for AI tool integrations
- Installed documents sidebar with update tracking and diff viewing
- Bookmarks & collections to organize your saved documents
- Deep links — open documents directly from the web via
vscode:// URIs
Getting Started
- Install the extension from the VS Code Marketplace
- Open the command palette (
Cmd+Shift+P / Ctrl+Shift+P) and run Elephant: Login
- Open any markdown file and click the elephant icon in the editor title bar to publish
Commands
Publishing
| Command |
Description |
Elephant: Publish to Elephant.md |
Publish the current markdown file with full metadata form |
Elephant: Publish Skill to Elephant.md |
Publish a skill file (auto-detected for SKILL.md) |
Elephant: Push Changes |
Push updates to a tracked document |
Pulling & Installing
| Command |
Description |
Elephant: Pull Document |
Pull a document into your workspace (search, browse, or enter reference) |
Elephant: Install Document |
Install a document into your AI agent's context |
Elephant: Configure MCP Server |
Set up the elephant.md MCP server for your agent |
Elephant: Update All Installed Documents |
Check for and apply updates to all installed documents |
Sharing & Discovery
| Command |
Description |
Elephant: Create Share Link |
Create an ephemeral share link (timed or view-once) |
Elephant: Search Documents |
Search for public documents |
Elephant: Trending Documents |
Browse trending documents |
Bookmarks & Collections
| Command |
Description |
Elephant: Toggle Bookmark |
Bookmark or unbookmark a tracked document |
Elephant: Create Collection |
Create a new collection |
Elephant: Add to Collection |
Add a tracked document to a collection |
Other
| Command |
Description |
Elephant: Login |
Authenticate with elephant.md |
Open in Elephant.md |
Open the current tracked document in your browser |
Right-click any markdown file or folder in the explorer to access Elephant commands:
- Markdown files — Publish, Push, Create Share Link, Open in Elephant.md
- Folders — Pull Document Here, Install from Elephant.md, Install Skills
Auto-Push
When enabled (on by default), saving a tracked markdown file automatically pushes changes to elephant.md. Changes are detected via SHA-256 hash comparison — unchanged files are skipped.
Document Tracking
Publishing or pulling a document creates an .elephant.json file in your workspace root, mapping local files to their remote counterparts:
{
"documents": {
"README.md": {
"id": "abc123",
"username": "username",
"slug": "readme"
}
}
}
The elephant icon in the activity bar shows all documents installed in the current workspace. From here you can:
- See which documents have upstream updates available
- Update individual documents or all at once
- View diffs between local and remote versions
- Open documents in the browser
- Uninstall documents
Deep Links
Documents on elephant.md include an "Open in VS Code" button. Clicking it opens the document directly in your editor via the vscode://elephant.elephant-vscode/open/@user/slug URI scheme.
Settings
| Setting |
Default |
Description |
elephant.autoPush.enabled |
true |
Automatically push tracked files on save |
elephant.autoPush.delay |
1000 |
Delay in ms before auto-pushing (300–10000) |
elephant.autoPush.showNotifications |
false |
Show notification when auto-push completes |
elephant.defaults.visibility |
private |
Default visibility for new documents |
elephant.defaults.category |
guides |
Default category for new documents |
elephant.sync.enabled |
false |
Periodically check installed documents for updates |
elephant.sync.interval |
300 |
Sync check interval in seconds (60–3600) |
elephant.sync.showNotifications |
true |
Notify when installed document updates are available |
Links
