Skip to content

Importing from a Markdown folder

When to use

The generic fallback for any folder of Markdown + YAML frontmatter that isn't a recognized app — a Zettlr project, a static-site content dir, a hand-rolled export, or the Markdown output of an app's exporter (Bear, Apple Notes, Craft, OneNote). You own it end to end. Read limestone-vault-conventions, working-with-collections, and importing-from-obsidian (the exact same mapping) first.

Run the import (one tool call)

Call limestone_import_notebook(path, collection_name) with the folder (or a .zip of it). Returns the usual summary + unconverted list.

What the tool does

Identical to importing-from-obsidian: each .md → a record; frontmatter created/updated/author/source/aliases → properties; tags: + inline #tags → real tags; ![[...]]/![](...) attachments copied beside the note; [[links]] pass through; any other frontmatter key preserved back into the note's YAML.

Finalizing (your job)

The importing-from-obsidian playbook applies verbatim: promote preserved frontmatter, retype properties, split/rename if one folder holds several record types, and resolve unconverted items (unsupported attachment types, unresolved embeds).

Evolving this skill

If a particular exporter's Markdown recurs with the same problems, consider giving it its own importing-from-<app> skill (and, if the structure needs code, an adapter on importers/markdown_folder.py). Keep skill and importer in sync.