Airalogy Markdown Studio

Airalogy Markdown Studio is a professional VS Code extension designed for editing and previewing AIMD (Airalogy Markdown) protocol files — an extended Markdown format for defining experimental protocols with interactive templates like variables, steps, and checkpoints. It provides a modern, "Scientific Minimalist" preview interface to help scientists and researchers visualize their experimental workflows.

Features

• Edit Mode: Directly edit protocol steps and text in the preview with a visual toolbar.
• Reverse Compiler: Changes made in the preview (Edit Mode) are instantly synced back to the AIMD source file.
• Record Mode: Session-based data recording workflow for experimental protocols with auto-save.
• Package Export: Export entire workspace packages as ZIP files for easy sharing.
• Interactive Timeline Preview: Visualize your protocol as a sleek, card-based timeline.
• Scientific Minimalist Design: High-fidelity UI inspired by professional lab design tools, offering high contrast and reduced visual clutter.
• Unified Rendering Engine: Powered by Remark/Rehype and Vue.js for robust and extensible document parsing.
• Python Backend Integration: Sidecar architecture for advanced features like AI assistance and data export.
• Real-time Synchronization: The preview updates instantly as you edit your .aimd files.
• Smart Variable Highlighting: Easily identify and interact with protocol variables.
• Dependency Graph Visualization: Interactive tree graph to visualize assigner dependencies and variable relationships.
• Workbench & Session Management: Dedicated sidebar for managing variables, assigners, and recording sessions.
• Enhanced Media Preview: Native support for TIFF images, video, and audio playback directly in the preview.
• Enhanced UI Controls: Support for Select/Dropdown components and typing.Literal for structured data input.
• Drag-and-Drop File Upload: Easily upload files by dragging them into variable inputs.
• Theme Support: Choose between Modern, Journal, Clinical, and Westlake themes with full dark mode support.
• Status Bar Integration: Quick access to preview commands directly from the status bar.

Usage

1. Open any file with the .aimd extension.
2. Click the AIMD Preview button in the status bar (bottom right).
3. Alternatively, use the preview icon in the editor title bar or the context menu.

Extension Settings

This extension contributes the following settings:

• aimd.preview.buttonText: Customize the status bar button text.
• aimd.preview.buttonIcon: Change the status bar icon (uses VS Code Codicons).
• aimd.preview.buttonPriority: Adjust the position of the status bar button.
• aimd.pythonMode: Python environment mode (system only).
• aimd.systemPythonPath: Path to the system Python executable (auto-synced with Python extension).

Python Dependencies

The following dependencies are required:

Core (Required):

• networkx>=3.0 - Graph algorithms for dependency DAG
• pydantic>=2.0 - Data validation for VarModel

Optional:

• airalogy - Airalogy SDK for assigner functionality

Install with:

pip install networkx>=3.0 pydantic>=2.0
pip install git+https://github.com/airalogy/airalogy  # Optional

Requirements

• VS Code version 1.74.0 or higher.
• Python 3.8+.

Changelog

See CHANGELOG.md for a detailed history of all releases.

Happy Experimenting!