README file from
GithubTNMSOP
TNMSOP safely opens prompt-focused .mdx files as native Markdown notes in Obsidian. It compiles a static subset in reading view without evaluating JavaScript or writing derived files into the vault.
Features
- Native
.mdxfile discovery, editing, links, and reading view - Static expressions resolved from plugin scope, frontmatter, and static exports
<Md>and<Md.Line>conditional prompt blocks- Vault-level preview toggle with a desktop status icon and a cross-platform command
- Fail-open rendering for unsupported or invalid MDX
Install
After the initial directory review, install TNMSOP from Settings > Community plugins > Browse in Obsidian.
For a manual installation, download main.js, manifest.json, and styles.css from the GitHub Release whose tag exactly matches the plugin version. Place them in:
<vault>/.obsidian/plugins/tnmsop/
Reload Obsidian, enable community plugins, and enable TNMSOP. Beta installations can use BRAT with TrueNine/croessweave-obsidian-plugin.
Use
Open an .mdx file as a normal note and switch to reading view to see the compiled preview. Use Settings > TNMSOP to toggle compiled previews and define a JSON object containing preview variables. The command palette also provides Toggle compiled prompt preview.
Safe Preview Scope
File YAML frontmatter overrides plugin scope, and static exports override frontmatter. Calls, assignments, dynamic imports, and other executable expressions are never run.
Development
bun install --frozen-lockfile
bun test
bun run check:type
bun run lint
bun run build
bun run verify:dist