@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/skills/figma-ios/figma-to-component/reference/code-connect.md

@@ -0,0 +1,531 @@
+# CODE CONNECT REFERENCE (SwiftUI)
+
+## 1. SETUP
+
+### 1.1 Prerequisites
+- Swift 6.0+ (Xcode 16.0+)
+- Node.js 18+
+- Figma Access Token with scopes: file_content:read, code_connect:write
+- PATs capped at 90-day expiry
+
+### 1.2 CLI Installation
+Two options:
+- Global: `npm install --global @figma/code-connect@latest` then `figma connect <cmd>`
+- No-install (npx): `npx @figma/code-connect@latest connect <cmd>` — recommended for CI/CD and machines without global install
+- Local dependency: if `@figma/code-connect` is a package dependency, just use `npx figma connect <cmd>` from the package root
+
+Current installed version: 1.3.12 (latest available: 1.4.1)
+
+### 1.3 SPM Dependency
+```swift
+.package(url: "https://github.com/figma/code-connect", from: "1.2.0")
+```
+Product: "Figma" library — provides property wrappers only. CLI is npm-based, NOT from SPM.
+
+### 1.4 Configuration (figma.config.json)
+```json
+{
+  "codeConnect": {
+    "parser": "swift",
+    "include": ["Sources/**/*.figma.swift"],
+    "exclude": ["Tests/**", ".build/**"],
+    "swiftPackagePath": "./Package.swift",
+    "sourcePackagesPath": "/path/to/DerivedData/SourcePackages"
+  }
+}
+```
+Note: sourcePackagesPath added in 1.3.5, optional. language field added in 1.3.13.
+
+### 1.5 Multi-Package Setup
+When `.figma.swift` files live in a package that doesn't directly depend on the Figma SDK:
+1. Point `swiftPackagePath` to the package that HAS the Figma dependency:
+   ```json
+   { "swiftPackagePath": "../ExternalPackages/Package.swift" }
+   ```
+2. Add `exclude: ["CodeConnect"]` to the target in `Package.swift` so `.figma.swift` files don't break compilation (the target doesn't import Figma):
+   ```swift
+   .target(name: "UIAssets", path: "iOS/Sources/UIAssets", exclude: ["CodeConnect"])
+   ```
+3. Set `include` to match the CodeConnect directory:
+   ```json
+   { "include": ["iOS/Sources/UIAssets/CodeConnect/**/*.figma.swift"] }
+   ```
+
+## 2. FILE FORMAT
+
+### 2.1 Naming
+| Item | Format |
+|------|--------|
+| File | `<ComponentName>.figma.swift` |
+| Struct | `<ComponentName>FigmaConnect` |
+
+### 2.2 Location
+```
+Component/
+├── Component.swift
+├── Component.figma.swift
+└── FIGMA.md
+```
+
+### 2.3 Template — Static (No Figma Properties)
+```swift
+import Figma
+import SwiftUI
+
+struct ComponentNameFigmaConnect: FigmaConnect {
+    let component = ComponentName.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+
+    var body: some View {
+        ComponentName(title: "Static Title", isEnabled: true)
+    }
+}
+```
+
+### 2.4 Template — Mapped Properties
+```swift
+import Figma
+import SwiftUI
+
+struct ComponentNameFigmaConnect: FigmaConnect {
+    let component = ComponentName.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+
+    @FigmaString("Label")
+    var label: String = "Default"
+
+    @FigmaEnum("Size", mapping: [
+        "Small": ComponentSize.small,
+        "Medium": ComponentSize.medium,
+        "Large": ComponentSize.large
+    ])
+    var size: ComponentSize = .medium
+
+    @FigmaBoolean("Disabled", hideDefault: true)
+    var disabled: Bool = false
+
+    var body: some View {
+        ComponentName(label: label)
+            .size(size)
+            .disabled(disabled)
+    }
+}
+```
+
+### 2.5 Template — Multi-Variant (string enum)
+```swift
+struct PrimaryButtonFigmaConnect: FigmaConnect {
+    let component = Button.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    let variant = ["Type": "Primary"]
+    var body: some View { Button("Label", style: .primary) }
+}
+
+struct SecondaryButtonFigmaConnect: FigmaConnect {
+    let component = Button.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    let variant = ["Type": "Secondary"]
+    var body: some View { Button("Label", style: .secondary) }
+}
+```
+
+### 2.6 Template — Multi-Variant (boolean gate)
+Use a computed `var variant` property when matching on a boolean toggle (e.g., "Label" on/off):
+```swift
+// Default struct (Label = true, the default)
+struct LabelBadgeFigmaConnect: FigmaConnect {
+    let component = LabelBadge.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    // no variant → matches when Label is true (default)
+    var body: some View { LabelBadge { config in config.text(text) } }
+}
+
+// Icon-only struct (Label = false)
+struct LabelBadgeIconOnlyFigmaConnect: FigmaConnect {
+    let component = LabelBadge.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    var variant: [String: Any]? { ["Label": false] }
+    var body: some View { LabelBadge { config in config.leftIcon(leftIcon) } }
+}
+```
+Figma shows the most specific matching struct. When "Label" is toggled off, the icon-only struct renders.
+
+### 2.7 Template — Icon/Symbol (no component)
+For simple icon nodes without component properties — no `let component`, no property wrappers:
+```swift
+struct PlusCircleFillIconConnect: FigmaConnect {
+    let figmaNodeUrl = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    var body: some View { Image.plusCircleFill }
+}
+```
+Used for bulk icon Code Connect. See `generate_icons.py` in the configuration package for batch generation.
+
+## 3. PROPERTY WRAPPERS
+
+| Wrapper | Figma Type | Swift Type | Example |
+|---------|-----------|------------|---------|
+| `@FigmaString("Name")` | TEXT | String | `@FigmaString("Label") var label: String = "Default"` |
+| `@FigmaEnum("Name", mapping: [...])` | VARIANT | Enum | `@FigmaEnum("Size", mapping: ["S": .small]) var size` |
+| `@FigmaBoolean("Name")` | BOOLEAN | Bool / Any | `@FigmaBoolean("Disabled") var disabled: Bool = false` |
+| `@FigmaInstance("Name")` | INSTANCE_SWAP | View | `@FigmaInstance("Icon") var icon: AnyView?` |
+| `@FigmaChildren(layers: [...])` | Nested | [View] | `@FigmaChildren(layers: ["Row"]) var children` |
+
+### hideDefault
+Omits parameter from code snippet when at default value:
+`@FigmaBoolean("Disabled", hideDefault: true) var disabled: Bool = false`
+
+### @FigmaBoolean with mapping
+Maps boolean to non-Bool types (e.g., optional Image). Use when a boolean toggle controls presence of a non-boolean value:
+```swift
+@FigmaBoolean("Left Icon", mapping: [true: Image(systemName: "plus.circle"), false: nil], hideDefault: true)
+var leftIcon: Image? = nil
+```
+When `hideDefault: true` and value is `nil` (default), the `.leftIcon(...)` line is omitted from the snippet entirely.
+
+**IMPORTANT — hideDefault default value trap:** When using `hideDefault: true` with a mapping, the **default value** determines which mapped result gets hidden. Set the default to the value you want HIDDEN (typically `nil` for optionals):
+
+```swift
+// CORRECT — default=nil: Text=true shows .initials("BT"), Text=false hides it
+@FigmaBoolean("Text", mapping: [true: "BT", false: nil], hideDefault: true)
+var initials: String? = nil
+
+// WRONG — default="BT": Text=true HIDES .initials("BT"), Text=false shows .initials(nil)
+@FigmaBoolean("Text", mapping: [true: "BT", false: nil], hideDefault: true)
+var initials: String? = "BT"  // ← "BT" matches default, so it's hidden!
+```
+
+### @FigmaEnum — prefer implicit shorthand
+Use `.success` instead of `LabelBadgeConfiguration.LabelBadgeState.success` in mappings. The parser captures the expression as-is via `trimmedDescription`, so shorter values produce cleaner snippets:
+```swift
+// GOOD — clean snippet output
+@FigmaEnum("State", mapping: ["Success": .success, "Warning": .warning])
+
+// BAD — verbose snippet output
+@FigmaEnum("State", mapping: ["Success": LabelBadgeConfiguration.LabelBadgeState.success])
+```
+
+### @FigmaInstance
+Maps instance-swap properties to render the swapped component's Code Connect inline:
+```swift
+@FigmaInstance("Icon")
+var icon: IconComponent
+
+var body: some View {
+    MyComponent()
+        .icon(icon)
+}
+```
+When a designer swaps the icon instance in Figma, Dev Mode renders that specific icon's Code Connect snippet inline.
+
+**Limitations:**
+- Does NOT support `hideDefault`. The line always renders in the snippet, even when the instance swap is hidden (boolean off), resulting in empty content like `.leftIcon()`.
+- Workaround: use `@FigmaBoolean` with `mapping:` instead when the instance swap is controlled by a boolean toggle.
+- Useful when the instance swap is always visible and you want the swapped component's Code Connect to render inline.
+
+### figmaApply
+Conditionally applies view modifiers based on a boolean condition. In Dev Mode, Figma only shows the branch that matches the current property value — keeping snippets clean.
+
+**Basic — show modifier only when true:**
+```swift
+@FigmaBoolean("Disabled", hideDefault: true)
+var disabled: Bool = false
+
+var body: some View {
+    MyComponent()
+        .figmaApply(disabled) { $0.opacity(0.5) }
+}
+```
+When `Disabled = false` (default + hideDefault), nothing renders. When `Disabled = true`, snippet shows `.opacity(0.5)`.
+
+**With elseApply — different modifiers per branch:**
+```swift
+@FigmaEnum("Type", mapping: ["Primary": true, "Secondary": false])
+var isPrimary: Bool = false
+
+var body: some View {
+    MyComponent()
+        .figmaApply(isPrimary) {
+            $0.tint(.blue)
+        } elseApply: {
+            $0.backgroundColor(.clear)
+        }
+}
+```
+`elseApply` is optional — omit it to show nothing when condition is false.
+
+**With @FigmaBoolean + chain modifier (project pattern):**
+```swift
+@FigmaBoolean("M&S Member", hideDefault: true)
+var showMember: Bool = false
+
+@FigmaString("Member Text")
+var memberText: String = "CLASSIC"
+
+var body: some View {
+    CheckinBoardingPassPassengerInfo(passengerName: passengerName, colorVariant: colorVariant)
+        .figmaApply(showMember) { $0.membershipInfo(.init(memberId: "TK 12345678", memberClass: memberText)) }
+}
+```
+Combines `hideDefault` boolean with a chain modifier that passes a nested configuration. When `M&S Member = false`, the `.membershipInfo(...)` line is hidden entirely in Dev Mode.
+
+**Multiple figmaApply — TYPE ERASURE WARNING:**
+
+`figmaApply` returns `some View`, NOT `Self`. This means chaining multiple `figmaApply` calls causes the second call's closure `$0` to be `some View` instead of the concrete view type — resulting in a compile error when calling component-specific modifiers inside the closure.
+
+```swift
+// ❌ COMPILE ERROR — second $0 is `some View`, not `MyComponent`
+var body: some View {
+    MyComponent(title: title)
+        .figmaApply(showIcon) { $0.leftIcon(icon) }      // returns some View
+        .figmaApply(showBadge) { $0.badge(badgeCount) }   // $0 is some View — .badge() not found
+}
+```
+
+**The parser supports multiple chained `figmaApply` calls** (it uses a multi-pass while loop to replace each one independently). The limitation is purely a Swift type-checker issue at compile time.
+
+**Workaround — direct modifiers first, single figmaApply last:**
+
+Apply concrete-type modifiers (chain modifiers from Configuration) directly, then place `figmaApply` as the LAST call in the chain since it erases the type:
+
+```swift
+// ✅ CORRECT — direct modifier preserves type, figmaApply goes last
+@FigmaBoolean("Show Badge", hideDefault: true)
+var showBadge: Bool = false
+
+@FigmaBoolean("Disabled", hideDefault: true)
+var isDisabled: Bool = false
+
+var body: some View {
+    MyComponent(title: title)
+        .showBadge(showBadge)                              // direct modifier, type preserved
+        .figmaApply(isDisabled) { $0.opacity(0.5) }        // figmaApply last, returns some View — OK
+}
+```
+
+**Multiple booleans — use direct modifiers + single figmaApply:**
+
+When a component has multiple boolean properties, prefer direct modifiers for Bool-to-Bool mappings and reserve `figmaApply` for conditional complex expressions (optional Strings, nested configs):
+
+```swift
+@FigmaBoolean("Whith Baby", hideDefault: true)
+var whithBaby: Bool = false
+
+@FigmaBoolean("+1 Boarding", hideDefault: true)
+var showBoardingDate: Bool = false
+
+var body: some View {
+    CheckinBoardingPassQrInfoGroup(
+        terminalNumber: "1", gateNumber: "G23",
+        seatNumber: "24 A", boardingTime: "23:30",
+        qrCodeData: "BOARDING-PASS-QR-DATA"
+    )
+    .whithBaby(whithBaby)                                   // Bool → Bool, direct modifier
+    .figmaApply(showBoardingDate) { $0.boardingDate("13 Eyl") }  // Bool → optional String, figmaApply last
+}
+```
+
+**If you MUST use multiple figmaApply (e.g., both need elseApply or complex expressions):**
+
+The parser handles it fine — it's only the Swift compiler that objects. Use the comment-out-after-publish pattern:
+
+1. Write the `.figma.swift` with multiple `figmaApply` calls
+2. Comment out the file content temporarily for `figma connect publish` (parser reads the file directly, not via Xcode build)
+3. Actually: the parser reads `.figma.swift` files via SwiftSyntax, NOT through Xcode compilation. So publish works regardless of build errors.
+4. After publish, comment out the body or the entire struct to prevent Xcode build failures:
+
+```swift
+// Published to Figma Dev Mode — commented to avoid type erasure build error
+// struct MyComponentFigmaConnect: FigmaConnect {
+//     ...
+//     var body: some View {
+//         MyComponent(title: title)
+//             .figmaApply(showIcon) { $0.leftIcon(icon) }
+//             .figmaApply(showBadge) { $0.badge(badgeCount) }
+//     }
+// }
+```
+
+**Preference order for multiple boolean properties:**
+1. **Direct modifier** (`.whithBaby(whithBaby)`) — cleanest, no type erasure
+2. **@FigmaBoolean with mapping** (`mapping: [true: "value", false: nil]`) — for Bool → optional type
+3. **Single figmaApply last** — for complex conditional expressions
+4. **Multiple figmaApply + comment after publish** — last resort when multiple complex conditionals needed
+
+**When to use figmaApply vs direct parameter:**
+- **Direct parameter**: Property maps 1:1 to init/modifier argument (e.g., `@FigmaEnum → colorStyle:`)
+- **Direct modifier with @FigmaBoolean**: Bool property maps 1:1 to Bool modifier parameter
+- **figmaApply**: Boolean controls presence/absence of a non-boolean modifier or configuration block
+- **figmaApply + elseApply**: Boolean switches between two different modifier expressions
+
+### @FigmaChildren
+Renders nested child instances that aren't bound to an instance-swap prop. Takes layer names as parameters (the Figma layer name, not the component name):
+```swift
+@FigmaChildren(layers: ["Header", "Row"])
+var contents: AnyView?
+
+var body: some View {
+    MyList {
+        contents
+    }
+}
+```
+Use when the component uses slot-based composition in Figma (e.g., a list with repeating row children).
+
+**Wildcard matching** — match any or partial layer names:
+```swift
+@FigmaChildren(layers: ["*"])           // all children
+var allItems: AnyView?
+
+@FigmaChildren(layers: ["Icon*"])       // partial match — "IconLeft", "IconRight", etc.
+var icons: AnyView?
+
+@FigmaChildren(layers: ["Tab 1", "Tab 2", "Tab 3"])  // multiple specific layers
+var tabs: AnyView?
+```
+Layer name matching is **case sensitive**. The nested instance must have its own separate Code Connect file.
+
+**Slots** — composable sub-areas within component instances where designers can place freeform content. Code Connect does NOT traverse slot children to generate code — it only renders a reference to the slot itself. Use `@FigmaChildren` to capture slot content.
+
+## 3.5 ADVANCED PATTERNS
+
+### Variant restrictions — multiple structs per component
+When a single Figma component maps to different Swift types based on variant, create multiple `FigmaConnect` structs pointing to the same node. Figma shows the most specific match:
+```swift
+// Matches when Type = "Primary"
+struct PrimaryButtonConnect: FigmaConnect {
+    let component = PrimaryButton.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    let variant = ["Type": "Primary"]
+    var body: some View { PrimaryButton(label: label) }
+}
+
+// Matches when Type = "Danger" AND Disabled = false
+struct DangerButtonConnect: FigmaConnect {
+    let component = DangerButton.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    let variant = ["Type": "Danger", "Disabled": false]
+    var body: some View { DangerButton(label: label) }
+}
+```
+More specific variant dictionaries take priority. Combine multiple variant properties for fine-grained matching.
+
+### Computed variant — boolean gate for separate structs
+Use a computed `var variant` property for dynamic matching (e.g., boolean toggles):
+```swift
+struct IconOnlyBadgeConnect: FigmaConnect {
+    let component = LabelBadge.self
+    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
+    var variant: [String: Any]? { ["Label": false] }
+    var body: some View { LabelBadge { config in config.leftIcon(icon) } }
+}
+```
+
+### @FigmaBoolean with custom mapping — non-Bool types
+Map boolean toggles to any Swift type, not just Bool. Useful for optional views:
+```swift
+// Boolean controls icon presence — maps to optional Image
+@FigmaBoolean("Has Icon", mapping: [true: Image(systemName: "star.fill"), false: nil], hideDefault: true)
+var icon: Image? = nil
+
+// Boolean controls text presence — maps to optional String
+@FigmaBoolean("Show Label", mapping: [true: "Default Label", false: nil], hideDefault: true)
+var label: String? = nil
+
+var body: some View {
+    MyComponent()
+        .icon(icon)
+        .label(label)
+}
+```
+When `Has Icon = false` (default + hideDefault), `.icon(...)` is omitted from snippet entirely.
+
+### @FigmaEnum — map to Bool for figmaApply
+Convert an enum variant to a boolean condition for use with `figmaApply`:
+```swift
+@FigmaEnum("State", mapping: ["Disabled": true, "Default": false, "Hover": false, "Active": false])
+var isDisabled: Bool = false
+
+var body: some View {
+    MyComponent()
+        .figmaApply(isDisabled) { $0.disabled(true).opacity(0.5) }
+}
+```
+
+### Preview as documentation
+Code Connect structs work as Xcode previews, eliminating redundant preview code:
+```swift
+#Preview {
+    ComponentNameFigmaConnect()
+}
+```
+This renders the exact same configuration shown in Figma Dev Mode, keeping code and design in sync.
+
+## 4. CLI COMMANDS
+
+| Command | Purpose |
+|---------|---------|
+| `figma connect create "FIGMA_URL"` | Generate .figma.swift from Figma node URL |
+| `figma connect parse` | Validate Code Connect files locally |
+| `figma connect publish` | Publish to Figma (makes visible in Dev Mode) |
+| `figma connect publish --dry-run` | Preview what would be published |
+| `figma connect unpublish --label="SwiftUI"` | Remove published connections (--label REQUIRED since 1.3.6) |
+
+Auth: set `FIGMA_ACCESS_TOKEN` env var, or use `--token=YOUR_TOKEN` flag.
+
+Keychain retrieve:
+```bash
+export FIGMA_ACCESS_TOKEN=$(security find-generic-password -a "$USER" -s "FIGMA_ACCESS_TOKEN" -w)
+```
+
+All commands work with npx: `npx @figma/code-connect@latest connect <command>`
+
+## 5. MCP vs CLI
+
+MCP tools do simple path mappings. CLI does rich property-mapped snippets.
+
+| Capability | MCP | CLI |
+|-----------|-----|-----|
+| Map Figma node → code file path | Yes (add_code_connect_map) | Not needed |
+| Auto-detect unmapped components | Yes (get_code_connect_suggestions) | No |
+| Generate .figma.swift with prop mappings | No | Yes (figma connect create) |
+| Publish dynamic snippets to Dev Mode | No | Yes (figma connect publish) |
+| Property mapping (@FigmaEnum etc.) | No | Yes |
+| Swift syntax parsing | No | Yes |
+
+**Use MCP** for AI agent context (which Swift file = which Figma node).
+**Use CLI** for real Code Connect with dynamic Dev Mode snippets.
+
+## 6. PARSER BEHAVIOR
+
+The CLI parser uses SwiftSyntax AST analysis. Key behaviors that affect what developers see in Dev Mode:
+
+| Element | Behavior |
+|---------|----------|
+| `//` comments in body | **Stripped** — never appear in snippet |
+| `import` statements beyond Figma/SwiftUI | **Stripped** — `imports: []` always empty |
+| View modifiers (`.renderingMode(.template)`) | **Preserved** — captured via `trimmedDescription` |
+| Property wrapper expressions | **Preserved** — any expression works (e.g., `Image(systemName: "x")`) |
+| `let component = X.self` | **Optional** — only needed for component-level Code Connect |
+
+Do NOT rely on comments or extra imports to communicate with developers in snippets. Use view modifiers or static values in body instead.
+
+## 7. ERROR REFERENCE
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| `Swift tools version X but installed is Y` | Wrong Swift | Update Xcode |
+| `SyntaxError: Unexpected end of JSON` | Swift version mismatch | Check Swift version |
+| `Property "X" does not exist` | Figma prop not found | Remove wrapper, use static value |
+| `Couldn't find a Figma access token` | Token not set | Set FIGMA_ACCESS_TOKEN |
+| `401 Unauthorized` | Invalid token | Regenerate with correct scopes |
+| `Could not find component at node` | Wrong nodeId | Use colon format, verify node |
+| `No Code Connect files found` | Wrong include | Check figma.config.json |
+| `no such module 'Figma'` | Not resolved | Run swift package resolve |
+
+## 8. VERIFICATION
+
+After publish, verify via MCP:
+```
+mcp__figma-remote__get_code_connect_map(fileKey: "KEY", nodeId: "X:Y")
+```
+Returns mapping if published. Allow 1-2 min propagation delay.

package/pipeline/skills/figma-ios/figma-to-component/reference/confluence-api.md

@@ -0,0 +1,89 @@
+# CONFLUENCE API REFERENCE
+
+---
+
+## Authentication
+
+| Platform | Method | Header |
+|----------|--------|--------|
+| Cloud (*.atlassian.net) | Basic Auth | `Authorization: Basic base64(username:token)` |
+| Data Center/Server | Bearer Token (PAT) | `Authorization: Bearer <token>` |
+
+---
+
+## Endpoints
+
+### Find Page
+```
+GET /rest/api/content?spaceKey={SPACE}&title={TITLE}&expand=version
+```
+Returns: `{ "results": [{ "id": "123456", "title": "...", "version": { "number": 5 } }] }`
+
+### Create Page
+```
+POST /rest/api/content
+Content-Type: application/json
+```
+Body: `{ "type": "page", "title": "...", "space": { "key": "SPACE_KEY" }, "body": { "wiki": { "value": "h1. Content", "representation": "wiki" } } }`
+
+### Update Page
+```
+PUT /rest/api/content/{pageId}
+Content-Type: application/json
+```
+Body: Same as create + `"id": "123456"` + `"version": { "number": N+1 }`
+
+### Upload Attachment
+```
+POST /rest/api/content/{pageId}/child/attachment
+Content-Type: multipart/form-data
+X-Atlassian-Token: nocheck
+```
+
+### List Attachments
+```
+GET /rest/api/content/{pageId}/child/attachment
+```
+
+### Delete Attachment
+```
+DELETE /rest/api/content/{attachmentId}
+```
+
+---
+
+## Content Formats
+
+| Format | Use Case |
+|--------|----------|
+| `wiki` | Wiki markup (simpler, recommended) |
+| `storage` | XHTML storage format (complex) |
+
+---
+
+## Wiki Markup Quick Reference
+
+| Markdown | Wiki Markup |
+|----------|-------------|
+| `# H1` | `h1. H1` |
+| `## H2` | `h2. H2` |
+| `**bold**` | `*bold*` |
+| `- item` | `* item` |
+| `---` | `----` |
+| `\|a\|b\|` (header) | `\|\|a\|\|b\|\|` |
+| `\|a\|b\|` (row) | `\|a\|b\|` |
+| `[text](url)` | `[text\|url]` |
+| image | `!image.png!` |
+| attachment link | `[^filename.csv]` |
+
+---
+
+## Macros
+
+```
+{toc}                             - Table of contents
+{panel:title=Title}content{panel} - Panel box
+{code:language=swift}code{code}   - Code block
+{note}text{note}                  - Note callout
+{warning}text{warning}            - Warning callout
+```