Integration Guide
Publish Obsidian notes with MDtoLink
Share any note from your vault as a URL. No Obsidian Publish subscription, no export step. One command from your vault directory and the note is live.
Setup in 3 steps
1. Install the MDtoLink CLI
Open your terminal and install the CLI globally:
npm install -g mdtolink2. Navigate to your vault
Point your terminal at your Obsidian vault directory:
cd ~/Documents/MyVault3. Publish any note
Pass the path to your note. Use --slug to pick a readable URL:
mdtolink publish "Daily Notes/2026-03-01.md" --slug daily-march-1The CLI prints the published URL. Share it with anyone.
Why this workflow
You keep using Obsidian for writing. MDtoLink handles the publishing part. That's it.
- ✓ No $8/mo Obsidian Publish fee. MDtoLink's free plan covers 5 documents. Pro is $6/mo if you need more.
- ✓ Works with any note in your vault. Daily notes, project docs, meeting notes, drafts. If it's a markdown file, you can publish it.
- ✓ The note stays in your vault. The URL is a published copy. Your local file doesn't change. Edit and re-publish whenever you want.
- ✓ No plugin required. MDtoLink is a standalone CLI. It doesn't need access to your vault's config or plugin ecosystem.
Frequently asked questions
- Does MDtoLink support Obsidian wiki links?
- No. MDtoLink renders standard markdown links only. Obsidian-specific syntax like [[wikilinks]] won't render. Stick to standard markdown links, or use Obsidian's strict line breaks mode for better compatibility.
- Can I publish my whole Obsidian vault?
- You can publish files one at a time. For a full vault-as-website experience, Obsidian Publish or Quartz are better fits. MDtoLink is designed for sharing individual notes as URLs.
- How does MDtoLink compare to Obsidian Publish?
- Obsidian Publish ($8/mo) gives you a full site with navigation, graph view, and wiki link support. MDtoLink gives you shareable URLs for individual notes, starting free. Different tools for different jobs. See the full comparison on our Obsidian Publish comparison page.
- Does MDtoLink support Obsidian plugins?
- No. MDtoLink renders standard markdown with GFM extensions (tables, task lists, footnotes). Plugin-specific syntax like dataview queries, templater blocks, or custom callout types won't render.
Want a detailed breakdown? Read the full MDtoLink vs Obsidian Publish comparison.
Publish your first Obsidian note in two minutes
Install the CLI, open your vault in a terminal, and run one command. That's the whole process.
Free plan includes 5 documents. View pricing for higher limits.