Text Formatter

Transform and optimize text content with intelligent structure analysis. Output format: BBCode + Markdown hybrid optimized for forum publishing.

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐ │ Text Formatter Architecture (BBCode + MD Mode) │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Phase 1: Input Collection → 接收文本/文件 │ │ ↓ │ │ Phase 2: Content Analysis → 分析结构、识别 Callout/Admonition │ │ ↓ │ │ Phase 3: Format Transform → 转换为 BBCode+MD 格式 │ │ ↓ │ │ Phase 4: Output & Preview → 保存文件 + 预览 │ │ │ └─────────────────────────────────────────────────────────────────┘

Key Design Principles

• Single Format Output: BBCode + Markdown hybrid (forum optimized)

• Pixel-Based Sizing: size=150/120/100/80 (not 1-7 levels)

• Forum Compatibility: Only use widely-supported BBCode tags

• Markdown Separators: Use --- for horizontal rules (not [hr] )

• No Alignment Tags: [align] not supported, avoid usage

Format Specification

Supported BBCode Tags

Tag Usage Example

[size=N]

Font size (pixels) [size=120]Title[/size]

[color=X]

Text color (hex/name) [color=#2196F3]Blue[/color] 或 [color=blue]

[b]

Bold [b]Bold text[/b]

[i]

Italic [i]Italic[/i]

[s]

Strikethrough [s]deleted[/s]

[u]

Underline [u]underlined[/u]

[quote]

Quote block [quote]Content[/quote]

[code]

Code block [code]code[/code]

[img]

Image [img]url[/img]

[url]

Link [url=link]text[/url]

[list]

List container [list][*]item[/list]

[spoiler]

Collapsible content [spoiler=标题]隐藏内容[/spoiler]

HTML to BBCode Conversion

HTML Input BBCode Output

<mark>高亮</mark>

[color=yellow]高亮[/color]

<u>下划线</u>

[u]下划线[/u]

<details><summary>标题</summary>内容</details>

[spoiler=标题]内容[/spoiler]

Unsupported Tags (Avoid!)

Tag Reason Alternative

[align]

Not rendered Remove or use default left

[hr]

Shows as text Use Markdown ---

<div>

HTML not supported Use BBCode only

[table]

Limited support Use list or code block

Size Hierarchy (Pixels)

Element Size Color Usage

Main Title 150 #2196F3 Document title

Section Title 120 #2196F3 Major sections (## H2)

Subsection 100 #333 Sub-sections (### H3)

Normal Text (default)

Body content

Notes/Gray 80 gray Footnotes, metadata

Color Palette

Color Hex Semantic Usage

Blue #2196F3 Titles, links, info

Green #4CAF50 Success, tips, features

Orange #FF9800 Warnings, caution

Red #F44336 Errors, danger, important

Purple #9C27B0 Examples, code

Gray gray Notes, metadata

Mandatory Prerequisites

Read before execution:

Document Purpose Priority

specs/format-rules.md Format conversion rules P0

specs/element-mapping.md Element type mappings P1

specs/callout-types.md Callout/Admonition types P1

Execution Flow

┌────────────────────────────────────────────────────────────────┐ │ Phase 1: Input Collection │ │ - Ask: paste text OR file path │ │ - Output: input-config.json │ ├────────────────────────────────────────────────────────────────┤ │ Phase 2: Content Analysis │ │ - Detect structure: headings, lists, code blocks, tables │ │ - Identify Callouts/Admonitions (>[!type]) │ │ - Output: analysis.json │ ├────────────────────────────────────────────────────────────────┤ │ Phase 3: Format Transform │ │ - Apply BBCode + MD rules from specs/format-rules.md │ │ - Convert elements with pixel-based sizes │ │ - Use Markdown --- for separators │ │ - Output: formatted content │ ├────────────────────────────────────────────────────────────────┤ │ Phase 4: Output & Preview │ │ - Save to .bbcode.txt file │ │ - Display preview │ │ - Output: final file │ └────────────────────────────────────────────────────────────────┘

Callout/Admonition Support

支持 Obsidian 风格的 Callout 语法，转换为 BBCode quote：

[!NOTE] 这是一个提示信息

[!WARNING] 这是一个警告信息

转换结果：

[quote] [size=100][color=#2196F3][b]📝 注意[/b][/color][/size]

这是一个提示信息 [/quote]

Type Color Icon

NOTE/INFO #2196F3 📝

TIP/HINT #4CAF50 💡

SUCCESS #4CAF50 ✅

WARNING/CAUTION #FF9800 ⚠️

DANGER/ERROR #F44336 ❌

EXAMPLE #9C27B0 📋

Directory Setup

const timestamp = new Date().toISOString().slice(0,10).replace(/-/g, ''); const workDir = .workflow/.scratchpad/text-formatter-${timestamp};

Bash(mkdir -p "${workDir}");

Output Structure

.workflow/.scratchpad/text-formatter-{date}/ ├── input-config.json # 输入配置 ├── analysis.json # 内容分析结果 └── output.bbcode.txt # BBCode+MD 输出

Reference Documents

Document Purpose

phases/01-input-collection.md 收集输入内容

phases/02-content-analysis.md 分析内容结构

phases/03-format-transform.md 格式转换

phases/04-output-preview.md 输出和预览

specs/format-rules.md 格式转换规则

specs/element-mapping.md 元素映射表

specs/callout-types.md Callout 类型定义

templates/bbcode-template.md BBCode 模板