Tiptap’s Conversion tools support handling Markdown (.md) files in three ways:
Editor Import – Convert .md files directly into Tiptap JSON for in-editor editing.
Editor Export – Convert Tiptap content into .md (either standard Markdown or GitHub Flavored Markdown).
REST API – Integrate markdown conversion on the server with the MD conversion REST API, without using the Tiptap editor directly.
Editor Markdown Import
The Conversion extensions are published in Tiptap’s private npm registry. Integrate the extensions by following the private registry guide.
Install the Import extension:
npm i @tiptap-pro/extension-import
Configure the extension in your editor
import { Import } from'@tiptap-pro/extension-import'const editor = newEditor({
// ...extensions: [
// ...Import.configure({
// Your Convert App ID from https://cloud.tiptap.dev/convert-settingsappId: 'your-app-id',
// JWT token you generatedtoken: 'your-jwt',
// If your markdown includes images, you can provide a URL for image uploadimageUploadCallbackUrl: 'https://your-image-upload-url.com',
}),
],
})
Import your first document
editor.chain().focus().import({ file }).run()
This uploads the chosen .md file to the Conversion API, converts it into Tiptap JSON, and replaces the current editor content.