Arkenstone Syntax
Arkenstone uses a standard Markdown structure enhanced with specific tags for project attributes. This structure allows Taskida to parse your text and synchronize it directly with the database.
# Website Redesign
A project to overhaul our landing page and customer portal.
> NOTE: **Accessibility**
> Reminder: Keep accessibility in mind for all designs.
> Test with screen readers.
## [ ] Initial Wireframes @[email protected] !high ^2026-03-15
Create low-fidelity wireframes for the homepage and product pages.
> NOTE: **Focus**
> Focus on the mobile-first layout.
- [ ] Homepage layout
- [ ] Product grid view
- [ ] Checkout flow
## [x] Audit Existing Site !med
Review the current site for pain points and speed issues.
- [x] Lighthouse audit
- [x] User feedback review
[x] Status
Use [ ] for pending tasks and [x] for completed ones. Toggling this updates completion timestamps automatically.
@ Assignee
Assign tasks by adding the user's email address (e.g., @[email protected]). They join the project team automatically.
! Priority
Set task urgency using !low, !med, or !high.
^ Due Date
Set deadlines using the ^YYYY-MM-DD format (e.g., ^2026-12-31).
Core Concepts
Hierarchy & Structure
Arkenstone follows a strict hierarchy to keep your data organized:
- Project Header (H1 - #): Sets the Project Name. The text immediately below becomes the Project Description.
- Task Header (H2 - ##): Creates a Task. Attributes like Assignee and Due Date are extracted from this line.
- Notes (Blockquotes - >): Prefixed with
NOTE:. You can set a note title using **Title** at the start. Notes can span multiple lines using >.
- Sub-tasks (List Items - -): Standard list items become sub-tasks (Todos) belonging to the task above.
Bidirectional Sync (Source of Truth)
Arkenstone is a bidirectional engine. When you open it, Taskida converts your database records into Markdown. When you click "Sync", Arkenstone converts your Markdown back into database records.
Important: Arkenstone is the Source of Truth. If you delete a line representing a task, note, or todo in the editor, that item will be permanently deleted from the database upon syncing.
AI-First Workflow
Arkenstone is engineered to work seamlessly with Large Language Models (LLMs) like ChatGPT, Claude, and Gemini. Instead of manually creating dozens of tasks, you can let an AI generate the entire project plan for you.
How to Prompt AI
Inside the Arkenstone Editor, click the "AI Prompt" button. This copies a specialized set of instructions to your clipboard designed specifically for LLMs.
Paste this prompt into your favorite AI tool along with your project requirements. The AI will respond with perfectly formatted Arkenstone Markdown that you can paste directly back into Taskida to create or update your entire project instantly.
Technical Detail: Record IDs
To maintain a perfect link between your text and the database, Arkenstone uses hidden HTML comments containing unique Record IDs (e.g., <!-- id:01JK... -->).
In the editor, these IDs appear on the line immediately preceding each task, note, or sub-task. These IDs allow Taskida to know exactly which records to update when you rename a task or move it around. Do not delete or modify these ID lines unless you intend to create a new duplicate record instead of updating the existing one.