Local Markdown
Cortex keeps Markdown files on disk as the source of truth, so notes stay readable with or without the app.
Cortex treats the folder on your computer as the durable workspace. The app adds navigation, search, preview, and extension surfaces around the files instead of replacing them.
Source of truth#
The file on disk is the canonical note. You can open it in another editor, back it up, version it with Git, or move it into another folder without asking Cortex for an export.
# Research noteTags: #writing #local-firstThe note is still text. Cortex adds the workspace around it.Markdown compatibility#
The renderer supports common Markdown patterns used in technical notes: headings, lists, links, tables, code blocks, task lists, callouts, tags, highlights, and wiki-style references where the app can resolve them. See Markdown Syntax for the details.
Cortex keeps its own state in a hidden .cortex folder next to your notes. See The .cortex Folder.
Metadata stays inspectable#
Properties and tags should remain understandable from the file. Cortex can make metadata easier to scan, but the content should still make sense in plain text.