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 模板