Importing Markdown files that include front-matter aliases

In TheBrain v15, that phrase describes a powerful capability for importing markdown-based note systems (like Obsidian or Logseq) into your brain while preserving all connected relationships.

1. Front-Matter Aliases

YAML Front-Matter is a block of metadata placed at the very top of a Markdown file wrapped between --- lines.

An alias gives a note alternative names or nicknames. For example:

---
title: Artificial Intelligence
aliases: [AI, Machine Learning, Deep Learning]
---
# Artificial Intelligence
...

In this note, AI and Machine Learning are set as alternative names for the main note "Artificial Intelligence".

2. Wikilinks

A Wikilink is a double-bracketed shortcut used in apps like Obsidian or Roam to link to another note without using full file paths:

• Example Wikilink: [[AI]] or [[Machine Learning]]

3. What "Resolving Wikilinks Through Them" Means

When you import a collection of Markdown files into TheBrain:

1. Without alias support: If Note B contained a Wikilink like [[AI]], TheBrain wouldn't know what AI was unless there was literally a file named AI.md. If the original file was named Artificial Intelligence.md, the link would break or create an orphaned/blank thought.

2. With alias support (TheBrain v15): TheBrain scans the front-matter metadata of all incoming files. When it sees [[AI]], it checks the aliases: field across all notes, realizes that AI is an alias for the note "Artificial Intelligence", and successfully connects the two thoughts together.

Summary