importer

Convert markdown files into TypeMD objects using the tmd CLI.

9|2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/typemd/typemd --skill importer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: importer
Source: https://github.com/typemd/typemd/tree/main/core/skills/importer
Command: npx skills add https://github.com/typemd/typemd --skill importer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Importer skill helps users migrate existing markdown notes into a TypeMD vault, eliminating manual object creation and ensuring consistency with existing schemas, properties, and relations.

Core Features & Use Cases

  • Schema‑aware classification: Analyzes vault type schemas and existing objects to choose the appropriate TypeMD type.
  • Automated object generation: Creates new objects with proper ULIDs, frontmatter, and body content.
  • Relation discovery: Detects and suggests wiki‑links and relation properties based on existing vault content.
  • Batch processing: Handles multiple files, maintains naming conventions, and proposes cross‑object links.

Quick Start

Ask the importer skill to convert your “meeting-notes.md” file into a TypeMD object.

Frequently Asked Questions about importer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert existing markdown files into structured objects?

You can batch import markdown files into a TypeMD vault by analyzing existing type schemas and properties to automatically classify content, generate ULID-named object files, and suggest wiki-links for relations.

What is schema-aware classification when importing markdown notes?

Schema-aware classification reads your vault's type schemas and existing objects during markdown import to choose the appropriate TypeMD type, ensuring new notes match your defined properties and relations without manual setup.

Can I batch import multiple markdown documents while maintaining naming conventions?

Yes, batch processing handles multiple markdown files at once, maintaining naming conventions by generating proper ULID-named object files and proposing cross-object wiki-links based on existing vault content.

Do I need type schema files and the tmd CLI to import markdown into a TypeMD vault?

Yes, importing markdown into a TypeMD vault requires access to the vault's type schema files, property definitions, and the tmd CLI to generate ULID-named object files and suggest wiki-links accurately.

How does relation discovery work when migrating markdown notes?

Relation discovery detects connections during markdown migration by analyzing existing vault content, then suggests wiki-links and relation properties to automatically link newly imported objects to related notes.

What's the best way to migrate markdown recipes and notes into a TypeMD vault?

The best way to migrate markdown recipes and notes into a TypeMD vault is using schema-aware batch processing, which assigns appropriate types, generates ULIDs, and suggests wiki-links to eliminate manual object creation.