### Install Mark CLI using Go Install

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Install the Mark CLI tool using the Go install command, specifying the module path and version.

```bash
go install github.com/kovetskiy/mark/v16/cmd/mark@latest
```

--------------------------------

### Install Mark CLI using Homebrew

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Install the Mark CLI tool using Homebrew by tapping the repository and running the install command.

```bash
brew tap kovetskiy/mark
brew install mark
```

--------------------------------

### Basic Bash Command

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.html

A simple bash command example.

```bash
A b c
```

--------------------------------

### Bash Script Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A simple bash script.

```bash
code bash
```

--------------------------------

### Inline Code Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.html

Demonstrates the use of inline code formatting.

```text
`inline`
```

--------------------------------

### Example of Unclosed Mention

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention-stripnewlines.html

Illustrates an unclosed mention syntax. This is a textual example, not executable code.

```text
Hello username! Unclosed @{mention Not a mention @{} Another one name Multiple one and two In a link [mention me](http://example.com) In a code `@{username}` In a block:

false

Indented:

false
```

--------------------------------

### Mark Metadata Headers Example

Source: https://github.com/kovetskiy/mark/blob/master/README.md

This example shows the extended markdown format with metadata headers for Confluence page configuration. Use these headers to specify space, parent pages, title, attachments, labels, and layout.

```markdown
<!-- Space: <space key> -->
<!-- Parent: <parent 1> -->
<!-- Parent: <parent 2> -->
<!-- Title: <title> -->
<!-- Attachment: <local path> -->
<!-- Label: <label 1> -->
<!-- Label: <label 2> -->
<!-- Image-Align: <left|center|right> -->

<page contents>
```

--------------------------------

### Shell Command Snippet

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A shell command example with specific attributes.

```sh
no-collapse-title
```

--------------------------------

### D2 Diagram Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes-stripnewlines.html

A D2 diagram illustrating system components and their interactions.

```d2
transmitter: send satellites -> transmitter: send satellites -> transmitter: send } online portal: { ui: {shape: hexagon} } data processor: { storage: { shape: cylinder style.multiple: true } } cell tower.transmitter -> data processor.storage: phone logs } user: { shape: person width: 130 } user -> network.cell tower: make call user -> network.online portal.ui: access { style.stroke-dash: 3 } api server -> network.online portal.ui: display api server -> logs: persist logs: {shape: page; style.multiple: true} network.data processor -> api server
```

--------------------------------

### Mark CLI Configuration File (TOML)

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Example TOML configuration file for storing user credentials and settings for the Mark CLI. Specify the config path using -c or --config.

```toml
username = "your-email"
password = "password-or-api-key-for-confluence-cloud"
# If you are using Confluence Cloud add the /wiki suffix to base_url
base-url = "http://confluence.local"
title-from-h1 = true
drop-h1 = true
image-align = "center"
```

--------------------------------

### Compile and Install Mark using Docker Compose

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Build the Mark binary using Docker Compose, which is useful for development or enhancement. The binary is then manually copied to the system's PATH.

```bash
# Create the binary
$ docker-compose run markbuilder
# "install" the binary
$ cp mark /usr/local/bin
```

--------------------------------

### Input Markdown Example

Source: https://github.com/kovetskiy/mark/blob/master/transformer/README.md

Demonstrates the usage of various GitHub Alert syntaxes within markdown, including notes, tips, and warnings, along with a regular blockquote for comparison.

```markdown
# Test GitHub Alerts

## Note Alert

> [!NOTE]
> This is a note alert with **markdown** formatting.
> 
> - Item 1
> - Item 2

## Tip Alert

> [!TIP]
> This is a tip alert.

## Warning Alert  

> [!WARNING]
> This is a warning alert.

## Regular Blockquote

> This is a regular blockquote without GitHub Alert syntax.
```

--------------------------------

### Unclosed Mention

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Shows an example of an unclosed mention syntax, which is not rendered as a mention.

```markdown
Unclosed @{mention
```

--------------------------------

### Output Confluence Storage Format Example

Source: https://github.com/kovetskiy/mark/blob/master/transformer/README.md

Shows the Confluence Storage Format generated by the transformer for a GitHub 'Note' alert, including preserved markdown and a user-friendly label.

```xml
<ac:structured-macro ac:name="info">
  <ac:parameter ac:name="icon">true</ac:parameter>
  <ac:rich-text-body>
    <p>Note</p>
    <p>This is a note alert with <strong>markdown</strong> formatting.</p>
    <ul>
      <li>Item 1</li>
      <li>Item 2</li>
    </ul>
  </ac:rich-text-body>
</ac:structured-macro>
```

--------------------------------

### Another Mention Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Provides another instance of a valid mention syntax.

```markdown
Another one @{name}
```

--------------------------------

### General Code Snippet

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A basic example of a code block.

```text
some code
```

--------------------------------

### Mark CLI File Globbing Example

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Demonstrates using file globbing with the Mark CLI to specify markdown files in a subdirectory. Use this to avoid manual file listing or find commands.

```bash
mark -f "helpful_cmds/*.md"
```

--------------------------------

### Valid Mention Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.html

Shows a standard @mention with a username, correctly identified.

```markdown
Another one name Multiple one and two
```

--------------------------------

### CI/CD Integration with Snake CI

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Example of integrating Mark CLI into a Snake CI pipeline for continuous documentation synchronization. This snippet runs on the main branch using the official Mark Docker image.

```yaml
stages:
  - sync

Sync documentation:
  stage: sync
  only:
    branches:
      - main
  image: kovetskiy/mark
  commands:
    - for file in $(find -type f -name '*.md'); do
        echo "> Sync $file";
        mark -u $MARK_USER -p $MARK_PASS -b $MARK_URL -f $file || exit 1;
        echo;
      done
```

--------------------------------

### Unclosed Mention Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.html

Demonstrates an unclosed @mention syntax which is not treated as a valid mention.

```markdown
Unclosed @{mention Not a mention @{}
```

--------------------------------

### D2 Diagram Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.html

A D2 diagram illustrating a system with multiple components and their interactions. Includes definitions for transmitter, online portal, data processor, cell tower, and user.

```d2
transmitter: send satellites -> transmitter: send } online portal: { ui: {shape: hexagon} } data processor: { storage: { shape: cylinder style.multiple: true } } cell tower.transmitter -> data processor.storage: phone logs } user: { shape: person width: 130 } user -> network.cell tower: make call user -> network.online portal.ui: access { style.stroke-dash: 3 } api server -> network.online portal.ui: display api server -> logs: persist logs: {shape: page; style.multiple: true} network.data processor -> api server
```

--------------------------------

### Mermaid Graph Example

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.html

Defines a basic Mermaid graph with nodes and directed edges.

```mermaid
B; A-->C; B-->D; C-->D;
```

--------------------------------

### Unknown Language Code Snippet 2

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

Another example of code in an unrecognized language.

```unknown
unknown code 2
```

--------------------------------

### Unknown Language Code Snippet 1

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

An example of code in an unrecognized language.

```unknown
unknown code
```

--------------------------------

### Insert PageTree

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Include a page tree using the 'ac:pagetree' template. This macro displays a hierarchical tree of pages starting from the current page.

```markdown
# My First Heading
<!-- Include: ac:pagetree -->
```

--------------------------------

### Preserve Inline Comments with Mark CLI

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Example of using the '--preserve-comments' flag with Mark CLI to maintain existing inline comments on Confluence pages during updates. This ensures review threads are not lost.

```bash
mark --preserve-comments -f docs/page.md
```

--------------------------------

### Basic Mention Syntax

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Demonstrates the basic syntax for creating a mention with a username. This is how mentions are typically represented in plain text.

```markdown
Hello @{username}!
```

--------------------------------

### Mark CLI Command-Line Flags

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Lists available command-line flags for the Mark CLI, including features, TLS verification, image alignment, help, and version.

```bash
--features string [ --features string ]  Enables optional features. Current features: d2, mermaid, mention, mkdocsadmonitions, plantuml (default: "mermaid", "mention") [$MARK_FEATURES]
   --insecure-skip-tls-verify               skip TLS certificate verification (useful for self-signed certificates) [$MARK_INSECURE_SKIP_TLS_VERIFY]
   --image-align string                     set image alignment (left, center, right). Can be overridden per-file via the Image-Align header. [$MARK_IMAGE_ALIGN]
   --help, -h                               show help
   --version, -v                            print the version
```

--------------------------------

### Run Mark CLI using Docker

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Execute the Mark CLI tool within a Docker container. The --rm flag ensures the container is removed after execution, and -i allows interactive input.

```bash
docker run --rm -i kovetskiy/mark:latest mark <params>
```

--------------------------------

### GitHub Alerts to Confluence Macros

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Convert GitHub-style alert syntax into Confluence macros for formatted information boxes. Supports NOTE, TIP, IMPORTANT, WARNING, and CAUTION.

```markdown
> [!NOTE]
> This creates a blue info box - perfect for helpful information!
```

```markdown
> [!TIP]
> This creates a green tip box - great for best practices and suggestions!
```

```markdown
> [!IMPORTANT]
> This creates a blue info box - ideal for critical information!
```

```markdown
> [!WARNING]
> This creates a yellow warning box - use for important warnings!
```

```markdown
> [!CAUTION]
> This creates a red warning box - perfect for dangerous situations!
```

--------------------------------

### GitHub Flavored Markdown Task Lists

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Implement task lists using GitHub Flavored Markdown syntax. Mark automatically converts these to Confluence task list elements.

```markdown
- [x] Finished task
- [ ] Unfinished task
```

--------------------------------

### Configuring Bash Code Blocks

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Configure bash code blocks with options like collapsing, titles, line numbers, and first line highlighting. Use '-' for language-agnostic blocks.

```bash
```bash
...
some long bash code block
...
```
```

```bash
bash collapse
```

```bash
bash collapse title Some long long bash function
```

```bash
bash linenumbers collapse title Some long long bash function
```

```bash
bash 1 collapse title Some long long bash function
```

```bash
bash 1 collapse midnight title Some long long bash function
```

```bash
- 1 collapse midnight title Some long long code
```

--------------------------------

### Render MkDocs Admonitions

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Enable mkdocs-style admonitions rendering via --features="mkdocsadmonitions". This feature renders note, warning, tip, and info admonitions as Confluence alerts.

```markdown
!!! note
```

--------------------------------

### Insert Status Badge with Macros

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Use macros to insert status badges like ':done:' and ':todo:' into a list. This helps in tracking task completion visually.

```markdown
<!-- Space: TEST -->
<!-- Title: TODO List -->

<!-- Macro: :done:
     Template: ac:status
     Title: DONE
     Color: Green -->

<!-- Macro: :todo:
     Template: ac:status
     Title: TODO
     Color: Blue -->

* :done: Write Article
* :todo: Publish Article
```

--------------------------------

### Render D2 Diagram

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Enable D2 diagram rendering by passing the --features="d2" flag. Code blocks marked as 'd2' will be transformed into PNGs for Confluence.

```d2
X -> Y
```

--------------------------------

### Attachment Declaration and Usage

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Declare local file paths as attachments in the header and reference them in the page content. Ensure paths are unique to avoid conflicts.

```markdown
<!-- Attachment: <path-to-image> -->

<beginning of page content>

An attached link is [here](<path-to-image>)
```

--------------------------------

### Mark CLI Recursive File Globbing

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Shows how to use the '**' wildcard with Mark CLI for recursive file matching, useful for projects with deeply nested documentation.

```bash
mark -f "**/docs/*.md"
```

--------------------------------

### Upload and Include Inline Image

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Include an image using Markdown syntax. Mark will automatically upload it as an attachment and use the 'ac:image' template.

```markdown
![Example](../images/examples.png)
```

--------------------------------

### Multiple Mentions

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Shows how to include multiple mentions within the same line of text.

```markdown
Multiple @{one} and @{two}
```

--------------------------------

### Go Template Inclusion

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Include Go templates into your markdown content. Specify the template path and optionally custom delimiters or configuration data in YAML format.

```markdown
<!-- Include: <path> -->
```

```markdown
<!-- Include: <path>
     Delims: "<<", ">>"
     -->
```

```markdown
<!-- Include: <path>
     <yaml-data> -->
```

--------------------------------

### Bash Script with Newline

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A bash script demonstrating a newline character.

```bash
with a newline


```

--------------------------------

### Bash Script for Syncing Markdown Files

Source: https://github.com/kovetskiy/mark/blob/master/README.md

A bash script to find all markdown files and sync them using the Mark CLI. This is typically used within a CI/CD environment.

```bash
for file in $(find -type f -name '*.md'); do
    echo "> Sync $file";
    mark -u $MARK_USER -p $MARK_PASS -b $MARK_URL -f $file || exit 1;
    echo;
done
```

--------------------------------

### Macro Definition

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Define custom macros using regular expressions and template files. Macros are processed before metadata like Title/Space.

```markdown
<!-- Macro: <regexp>
     Template: <path>
     <yaml-data> -->
```

--------------------------------

### Insert Colored Text Box with Macros

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Define and use macros to insert colored text boxes with icons and titles. Supports 'info', 'tip', 'note', and 'warning' types.

```markdown
<!-- Space: TEST -->
<!-- Title: Announcement -->

<!-- Macro: :box:([^:]+):([^:]*):(.+):
     Template: ac:box
     Icon: true
     Name: ${1}
     Title: ${2}
     Body: ${3} -->

:box:info::Foobar:
:box:tip:Tip of day:Foobar:
:box:note::Foobar:
:box:warning:Alert!:Foobar:
```

--------------------------------

### Nested Code Block

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

Demonstrates nested code blocks within a single definition.

```text
code
```
more code 
```
even more code
```

--------------------------------

### Basic PlantUML Sequence Diagram

Source: https://github.com/kovetskiy/mark/blob/master/testdata/plantuml.md

A simple PlantUML diagram illustrating a basic authentication request and response between two participants.

```plantuml
@startuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
@enduml
```

--------------------------------

### Empty Mention

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Illustrates an empty mention syntax, which is not recognized as a valid mention.

```markdown
Not a mention @{}
```

--------------------------------

### Insert Disclaimer into Article

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Include a disclaimer file into your main article. This is useful for generated documents that should not be edited manually.

```markdown
<!-- Space: TEST -->
<!-- Title: My Article -->

<!-- Include: disclaimer.md -->

This is my article.
```

--------------------------------

### Parametrized Children Display

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Customize the children display macro with various parameters like 'Sort', 'Style', 'Excerpt', 'First', 'Page', 'Depth', 'Reverse', and 'All'.

```markdown
<!-- Macro: :children:
     Template: ac:children
     Sort: title
     Style: h3
     Excerpt: simple
     First: 10
     Page: Space:Page title
     Depth: 2
     Reverse: false
     All: false -->

# This is my nicest title

:children:
```

--------------------------------

### D2 Diagram

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A D2 diagram defining a network infrastructure and user interactions.

```d2
vars: {
    d2-config: {
    layout-engine: elk
    # Terminal theme code
    theme-id: 300
  }
}
network: {
    cell tower: {
    satellites: {
      shape: stored_data
      style.multiple: true
    }

    transmitter

    satellites -> transmitter: send
    satellites -> transmitter: send
    satellites -> transmitter: send
  }

  online portal: {
    ui: {shape: hexagon}
  }

  data processor: {
    storage: {
      shape: cylinder
      style.multiple: true
    }
  }

  cell tower.transmitter -> data processor.storage: phone logs
}

user: {
  shape: person
  width: 130
}

user -> network.cell tower: make call
user -> network.online portal.ui: access {
  style.stroke-dash: 3
}

api server -> network.online portal.ui: display
api server -> logs: persist
logs: {shape: page; style.multiple: true}

network.data processor -> api server

```

--------------------------------

### Render Mermaid Diagram

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Render Mermaid diagrams directly in Mark by using a code block with the 'mermaid' language identifier. Mark converts it to a PNG and attaches it.

```mermaid
graph TD;
A-->B;
```

--------------------------------

### Simple PlantUML Diagram

Source: https://github.com/kovetskiy/mark/blob/master/testdata/plantuml-droph1.html

A basic PlantUML diagram showing a simple interaction between two participants.

```plantuml
@startuml
Bob: Authentication Request
Bob --> Alice: Authentication Response
@enduml
```

--------------------------------

### Mention in a Link

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Demonstrates how a mention appears when embedded within a Markdown link. The mention syntax is preserved within the link text.

```markdown
In a link [mention @{me}](http://example.com)
```

--------------------------------

### Custom Page Layout with HTML Comments

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Use HTML comments within markdown to define custom page layouts and sections. This allows for flexible content arrangement.

```markdown
<!-- Layout: plain -->
<!-- ac:layout -->

<!-- ac:layout-section type:three_with_sidebars -->
<!-- ac:layout-cell -->
More Content
<!-- ac:layout-cell -->
<!-- ac:layout-cell -->
More Content
<!-- ac:layout-cell -->
<!-- ac:layout-cell -->
Even More Content
<!-- ac:layout-cell -->
<!-- ac:layout-section end -->

<!-- ac:layout-section type:single -->
<!-- ac:layout-cell -->
Still More Content
<!-- ac:layout-cell -->
<!-- ac:layout-section end -->

<!-- ac:layout end -->
```

--------------------------------

### Complex PlantUML Sequence Diagram with Participants

Source: https://github.com/kovetskiy/mark/blob/master/testdata/plantuml.md

An advanced PlantUML diagram demonstrating various participant types like participant, actor, boundary, control, entity, database, collections, and queue.

```plantuml
@startuml
participant Participant as Foo
actor Actor as Foo1
boundary Boundary as Foo2
control Control as Foo3
entity Entity as Foo4
database Database as Foo5
collections Collections as Foo6
queue Queue as Foo7
Foo -> Foo1 : To actor
Foo -> Foo2 : To boundary
Foo -> Foo3 : To control
Foo -> Foo4 : To entity
Foo -> Foo5 : To database
Foo -> Foo6 : To collections
Foo -> Foo7: To queue
@enduml
```

--------------------------------

### Parametrized PageTree

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Customize the page tree macro with parameters such as 'Reverse', 'ExpandCollapseAll', and 'StartDepth'. The 'Template' must be 'ac:pagetree'.

```markdown
<!-- Macro: :pagetree:
     Template: ac:pagetree
     Reverse: 'true'
     ExpandCollapseAll: 'true'
     StartDepth: 2 -->

# My First Heading

:pagetree:
```

--------------------------------

### Link to Confluence Page by Title

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Create links to existing Confluence pages by their title using the 'ac:Pagetitle' syntax. Handles titles with spaces using angle brackets.

```markdown
This is a [link to an existing confluence page](ac:Pagetitle)

And this is how to link when the linktext is the same as the [Pagetitle](ac:)

Link to a [page title containing spaces](<ac:With Multiple Words>)
```

--------------------------------

### Mention in Code Block

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Shows how mention syntax is rendered within a fenced code block. The content inside the code block is treated as literal code.

```markdown
```
@{username}
```
```

--------------------------------

### Collapsible Bash Snippet with Title

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A collapsible bash code block with a title.

```bash
collapse-and-title
```

--------------------------------

### Optional Layout and Type Headers

Source: https://github.com/kovetskiy/mark/blob/master/README.md

These optional headers control the Confluence page layout and type. 'article' and 'plain' affect content width, while 'page' and 'blogpost' define the content type.

```markdown
<!-- Layout: (article|plain) -->

<!-- Type: (page|blogpost) -->
```

--------------------------------

### Macro with Inline Template

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Defines a macro that uses an inline template. The template content is specified within the YAML data, prefixed with '#'.

```markdown
<!-- Macro: <tblbox\s+(.*?)\s*>
     Template: #inline
     title: ${1}
     inline: |
         <table>
         <thead><tr><th>{{ .title }}</th></tr></thead>
         <tbody><tr><td>
      -->
```

```markdown
<!-- Macro: </tblbox>
     Template: #also_inline
     also_inline: |
         </td></tr></tbody></table>
      -->
```

--------------------------------

### Defining Placeholders

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Define placeholders within your markdown content using HTML comments. These can be used to mark specific areas for dynamic content or other purposes.

```markdown
<!-- ac:placeholder -->
Placeholder
<!-- ac:placeholder end -->
```

--------------------------------

### Insert Jira Ticket

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Link to Jira tickets using a macro that extracts the ticket number from the text. The 'Template' is 'ac:jira:ticket'.

```markdown
<!-- Space: TEST -->
<!-- Title: TODO List -->

<!-- Macro: MYJIRA-\d+
     Template: ac:jira:ticket
     Ticket: ${0} -->

See task MYJIRA-123.
```

--------------------------------

### Content Appearance Header

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Control the content's appearance on the Confluence page using this header. Options include 'full-width', 'fixed', or 'default' for standard narrow layout.

```markdown
<!-- Content-Appearance: (full-width|fixed|default) -->
```

--------------------------------

### Mention within a Link

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.html

Illustrates how @mentions are handled when they appear inside a markdown link.

```markdown
In a link [mention me](http://example.com)
```

--------------------------------

### Mermaid Diagram

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A basic Mermaid diagram illustrating a graph.

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

```

--------------------------------

### Image Alignment Header

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Set the alignment for all images within the markdown content. Common values are 'left', 'center', and 'right'. Note that wide images may automatically center.

```markdown
<!-- Image-Align: center -->
```

--------------------------------

### Parametrized Table of Contents

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Customize the table of contents macro by providing parameters like 'Printable' and 'MinLevel'. Note the single quotes around boolean values.

```markdown
<!-- Macro: :toc:
     Template: ac:toc
     Printable: 'false'
     MinLevel: 2 -->

# This is my nice title

:toc:
```

--------------------------------

### Insert Children Display

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Use the 'ac:children' template to display a list of child pages. This macro is useful for showing sub-pages or related content.

```markdown
<!-- Macro: :children:
     Template: ac:children
-->

# This is my nicer title

:children:
```

--------------------------------

### Mention within a Block

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.html

Demonstrates an @mention appearing within a markdown block, which is not rendered as a mention.

```markdown
In a block:

false
```

--------------------------------

### Mention in Indented Code Block

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.md

Demonstrates the rendering of mention syntax within an indented code block. Similar to fenced code blocks, it is treated as literal text.

```markdown
    @{username}
```

--------------------------------

### Disabling Include Delimiters

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Turn off Go template processing for an include directive by setting delimiters to 'none'. This prevents template expansion.

```markdown
<!-- Include: <path>
     Delims: none
     -->
```

--------------------------------

### Collapsible C Code Snippet

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A collapsible code block in C.

```c
collapse-no-title
```

--------------------------------

### Add Width to Image

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Specify image width by adding an HTML comment with 'width=' after the image source. This is not compatible with automated image uploads.

```markdown
<!-- Macro: \!\[.*\]\((.+)\)\<\!\-\- width=(.*) \-\-\> 
     Template: ac:image
     Attachment: ${1}
     Width: ${2} -->
```

```markdown
![Example](../images/example.png)<!-- width=300 -->
```

--------------------------------

### Sidebar and Emoji Headers

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Configure the page sidebar with HTML content or set a page emoji icon using these headers. The 'Sidebar' header adds a right-hand column, and 'Emoji' sets the page icon.

```markdown
<!-- Sidebar: <h2>Test</h2> -->
<!-- Emoji: 🚀 -->
```

--------------------------------

### Complex PlantUML Diagram with Multiple Elements

Source: https://github.com/kovetskiy/mark/blob/master/testdata/plantuml-droph1.html

An advanced PlantUML diagram illustrating various element types and their connections.

```plantuml
@startuml
Foo1 : To actor
Foo -> Foo2 : To boundary
Foo -> Foo3 : To control
Foo -> Foo4 : To entity
Foo -> Foo5 : To database
Foo -> Foo6 : To collections
Foo -> Foo7: To queue
@enduml
```

--------------------------------

### Insert Table of Contents

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Include a table of contents using the 'ac:toc' template. This macro automatically generates a TOC based on headings.

```markdown
<!-- Include: ac:toc -->
```

--------------------------------

### Macro with Capture Group Reference

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Defines a macro with a regular expression that includes capture groups. These groups can be referenced in the YAML data using ${number} syntax.

```markdown
<!-- Macro: MYJIRA-\d+
     Template: ac:jira:ticket
     Ticket: ${0} -->
```

--------------------------------

### Preserve Inline Comments via Environment Variable

Source: https://github.com/kovetskiy/mark/blob/master/README.md

Alternative method to preserve inline comments using the MARK_PRESERVE_COMMENTS environment variable. This achieves the same result as the command-line flag.

```bash
MARK_PRESERVE_COMMENTS=true mark -f docs/page.md
```

--------------------------------

### Mention with Indentation

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.html

Shows an @mention within an indented markdown block, also not rendered as a mention.

```markdown
Indented:

false
```

--------------------------------

### Mention within Inline Code

Source: https://github.com/kovetskiy/mark/blob/master/testdata/mention.html

Shows an @mention enclosed in backticks, treated as literal code.

```markdown
In a code `@{username}`
```

--------------------------------

### CI Branch Restriction

Source: https://github.com/kovetskiy/mark/blob/master/README.md

YAML configuration to restrict a CI job to only run when changes are pushed to the 'main' branch. This prevents automatic updates from feature branches.

```yaml
only:
  branches:
    - main
```

--------------------------------

### Indented Code Block

Source: https://github.com/kovetskiy/mark/blob/master/testdata/codes.md

A code block formatted with indentation.

```text
    indented code block
    with multiple lines


```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.