Back to Documentation

Getting Started

Getting Started

Welcome to mdsync.app! This guide will help you get started with syncing your GitHub documentation to Notion.

What is mdsync?

mdsync.app is a SaaS tool that automatically syncs your markdown documentation from GitHub repositories to Notion workspaces. This allows your non-technical team members to access documentation in Notion without ever touching a GitHub repository.

Key Features

  • One-Way Sync: Automatically syncs from GitHub to Notion (GitHub is the source of truth)
  • Structure Preservation: Your repository folder structure is perfectly mirrored in Notion
  • Automatic Updates: Webhooks automatically trigger syncs on every push (Starter & Pro plans)
  • Markdown Support: Full markdown support including headers, lists, code blocks, images, tables, and more
  • Easy Setup: Get started in minutes with our step-by-step wizard

Subscription Plans

  • Free: 1 sync, 10 markdown files, 30 images, manual sync only
  • Starter (€5/month): 2 syncs, 200 markdown files, 2000 images, automatic webhooks, 30-day free trial
  • Pro (€10/month): 5 syncs, 500 markdown files, 5000 images, automatic webhooks, priority support

Next Steps

  1. Quick Start Guide - Set up your first sync in 5 minutes
  2. Authentication - Connect your GitHub and Notion accounts
  3. Creating Your First Sync - Detailed walkthrough of the sync wizard
Getting Started | Documentation | mdsync.app