@jjlmoya/utils-games-development 1.53.0 → 1.55.0

package/src/tool/steamBbcodeTranslator/i18n/tr.ts

@@ -0,0 +1,195 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { SteamBbcodeTranslatorUI } from '../ui';
+import { bibliographyEntries } from '../bibliography';
+
+export const content: ToolLocaleContent<SteamBbcodeTranslatorUI> = {
+  slug: 'steam-bbcode-donusturucu',
+  title: 'Steam BBCode, Markdown ve HTML Donusturucu',
+  description: 'Steam BBCode, Markdown ve HTML formatlari arasinda otomatik sozvarligi tespiti ve canli onizleme ile cift yonlu donusturme yapin.',
+  ui: {
+    editorLabel: 'Bicimlendirilmis metninizi yapistirin',
+    editorHint: 'BBCode, Markdown veya HTML siz yazarken otomatik olarak algilanir.',
+    detectedLabel: 'Algilanan',
+    detectedEmpty: 'Metin bekleniyor',
+    bbcode: 'Steam BBCode',
+    markdown: 'Markdown',
+    html: 'HTML',
+    clear: 'Temizle',
+    copy: 'Sonucu kopyala',
+    copied: 'Panoya kopyalandi',
+    characters: 'Karakterler',
+    blocks: 'Bloklar',
+    privacyNote: 'Tarayicinizda calisir. Hicbir sey yuklenmez.',
+    persistenceNote: 'Son taslak yerel olarak kaydedildi',
+    previewLabel: 'Onizleme',
+    previewEmpty: 'Bicimlendirilmis onizlemeniz burada gorunur.'
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: 'Magaza aciklamalari neden donusturucuye ihtiyac duyar'
+    },
+    {
+      type: 'paragraph',
+      html: 'Steam magaza aciklamalari BBCode kullanir. Basin kitleri veya dokuman siteleri Markdown veya HTML gerektirir. Bu arac formatlar arasinda otomatik donusum saglar.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Desteklenen etiketler'
+    },
+    {
+      type: 'paragraph',
+      html: 'Basliklar, kalin, italik, baglantilar, listeler, alintilar ve spoiler etiketleri desteklenir.'
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { label: 'Girdi formati', value: '3' },
+        { label: 'Cikti formati', value: '2' },
+        { label: 'Liste derinligi', value: 'Ic ice' },
+        { label: 'Islem', value: 'Sadece tarayici' }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Ic ice listelerin korunmasi'
+    },
+    {
+      type: 'paragraph',
+      html: 'Hiyerarsik yapi agaci alt listelerin ana oge icinde kalmasini saglar.'
+    },
+    {
+      type: 'table',
+      headers: ['Steam BBCode', 'Markdown', 'HTML'],
+      rows: [
+        ['[h1]Baslik[/h1]', '# Baslik', '&lt;h1&gt;Baslik&lt;/h1&gt;'],
+        ['[b]Onemli[/b]', '**Onemli**', '&lt;strong&gt;Onemli&lt;/strong&gt;'],
+        ['[i]Not[/i]', '*Not*', '&lt;em&gt;Not&lt;/em&gt;'],
+        ['[url=https://example.com]Baglanti[/url]', '[Baglanti](https://example.com)', '&lt;a href="https://example.com"&gt;Baglanti&lt;/a&gt;'],
+        ['[list][*]Bir[*]Iki[/list]', '- Bir\n- Iki', '&lt;ul&gt;&lt;li&gt;Bir&lt;/li&gt;&lt;li&gt;Iki&lt;/li&gt;&lt;/ul&gt;']
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Markdown ve HTML farkliliklari'
+    },
+    {
+      type: 'paragraph',
+      html: 'Markdown alti cizili metni yerel olarak desteklemediginde HTML etiketleri kullanilir.'
+    },
+    {
+      type: 'tip',
+      title: 'Yayinlama oncesi kontrol',
+      html: 'Yayinlamadan once onizleme ekranindaki ciktilari kaynak belgenizle karsilastirin.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Veri gizliligi'
+    },
+    {
+      type: 'paragraph',
+      html: 'Tum islemler tamamen yerel olarak tarayicinizda gerceklesir.'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Sinirlamalar'
+    },
+    {
+      type: 'proscons',
+      title: 'Dikkat edilecekler',
+      items: [
+        {
+          pro: 'Liste yapisi korunur.',
+          con: 'Ozel etiketler manuel kontrol gerektirebilir.'
+        }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Terimler sozlugu'
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'BBCode',
+          definition: 'Steam tarafindan kullanilan kosebenti etiket yapisi.'
+        },
+        {
+          term: 'Markdown',
+          definition: 'Kolay okunabilir duz metin bicimlendirme dili.'
+        },
+        {
+          term: 'HTML',
+          definition: 'Web sayfalari icin standart isaretleme dili.'
+        }
+      ]
+    }
+  ],
+  faqTitle: 'Sikca sorulan sorular',
+  faq: [
+    {
+      question: 'Metnim bir sunucuya gonderiliyor mu?',
+      answer: 'Hayir. Donusum tamamen tarayicinizda gerceklesir.'
+    },
+    {
+      question: 'Ic ice listeler destekleniyor mu?',
+      answer: 'Evet. Liste yapisi donusumden once cozümlenir.'
+    }
+  ],
+  howTo: [
+    {
+      name: 'Metni yapistirin',
+      text: 'Steam BBCode, Markdown veya HTML yapistirin.'
+    },
+    {
+      name: 'Otomatik donusum',
+      text: 'Diger iki format aninda olusturulur.'
+    }
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Steam BBCode, Markdown ve HTML Donusturucu',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'TRY' }
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: 'Metnim bir sunucuya gonderiliyor mu?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Hayir. Donusum tamamen tarayicinizda gerceklesir.'
+          }
+        }
+      ]
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Steam BBCode, Markdown ve HTML nasil donusturulur',
+      step: [
+        {
+          '@type': 'HowToStep',
+          name: 'Metni yapistirin',
+          text: 'Steam BBCode, Markdown veya HTML yapistirin.'
+        }
+      ]
+    }
+  ],
+  bibliography: bibliographyEntries
+};

package/src/tool/steamBbcodeTranslator/i18n/zh.ts

@@ -0,0 +1,195 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { SteamBbcodeTranslatorUI } from '../ui';
+import { bibliographyEntries } from '../bibliography';
+
+export const content: ToolLocaleContent<SteamBbcodeTranslatorUI> = {
+  slug: 'steam-bbcode-translator',
+  title: 'Steam BBCode, Markdown 与 HTML 转换器',
+  description: '支持 Steam BBCode、Markdown 和 HTML 之间的双向自动识别转换与实时预览。',
+  ui: {
+    editorLabel: '粘贴您的富文本',
+    editorHint: '输入时将自动识别 BBCode、Markdown 或 HTML 格式。',
+    detectedLabel: '识别格式',
+    detectedEmpty: '等待输入文本',
+    bbcode: 'Steam BBCode',
+    markdown: 'Markdown',
+    html: 'HTML',
+    clear: '清空',
+    copy: '复制输出',
+    copied: '已复制到剪贴板',
+    characters: '字符数',
+    blocks: '区块数',
+    privacyNote: '在浏览器中本地运行，无需上传。',
+    persistenceNote: '最后草稿已保存在本地',
+    previewLabel: '预览',
+    previewEmpty: '格式化后的预览将在此显示。'
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: '为什么商店文案需要格式转换器'
+    },
+    {
+      type: 'paragraph',
+      html: 'Steam 商店页面编辑使用 BBCode 语法，而新闻资料包或文档网站通常使用 Markdown 或 HTML。本工具能够自动识别并同步生成其他两种格式。'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '支持的标记与结构'
+    },
+    {
+      type: 'paragraph',
+      html: '支持标题、加粗、斜体、链接、列表、引用与黑幕剧透标记的转换。'
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { label: '输入格式', value: '3 种' },
+        { label: '同时输出', value: '2 种' },
+        { label: '列表深度', value: '支持嵌套' },
+        { label: '数据处理', value: '纯本地' }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '保留嵌套列表结构'
+    },
+    {
+      type: 'paragraph',
+      html: '通过构建轻量级语法树，确保子列表项在转换后依然精确嵌套在父级列表中。'
+    },
+    {
+      type: 'table',
+      headers: ['Steam BBCode', 'Markdown', 'HTML'],
+      rows: [
+        ['[h1]标题[/h1]', '# 标题', '&lt;h1&gt;标题&lt;/h1&gt;'],
+        ['[b]重点[/b]', '**重点**', '&lt;strong&gt;重点&lt;/strong&gt;'],
+        ['[i]备注[/i]', '*备注*', '&lt;em&gt;备注&lt;/em&gt;'],
+        ['[url=https://example.com]链接[/url]', '[链接](https://example.com)', '&lt;a href="https://example.com"&gt;链接&lt;/a&gt;'],
+        ['[list][*]第一[*]第二[/list]', '- 第一\n- 第二', '&lt;ul&gt;&lt;li&gt;第一&lt;/li&gt;&lt;li&gt;第二&lt;/li&gt;&lt;/ul&gt;']
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Markdown 与 HTML 转换差异'
+    },
+    {
+      type: 'paragraph',
+      html: '当 Markdown 原生不支持下划线等样式时，转换器会自动补充内联 HTML 标签。'
+    },
+    {
+      type: 'tip',
+      title: '发布前检查建议',
+      html: '在发布到 Steam 或官网之前，请在预览面板中核对排版效果。'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '隐私与数据安全'
+    },
+    {
+      type: 'paragraph',
+      html: '所有转换均在您的浏览器本地完成，绝不会上传任何未公开文案。'
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '转换说明'
+    },
+    {
+      type: 'proscons',
+      title: '转换特点',
+      items: [
+        {
+          pro: '结构化处理嵌套列表。',
+          con: '自定义非标标签需手动复核。'
+        }
+      ]
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: '术语表'
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'BBCode',
+          definition: 'Steam 商店页面使用的方括号标记语法。'
+        },
+        {
+          term: 'Markdown',
+          definition: '易读易写的轻量级标记语言。'
+        },
+        {
+          term: 'HTML',
+          definition: '网页标准的超文本标记语言。'
+        }
+      ]
+    }
+  ],
+  faqTitle: '常见问题解答',
+  faq: [
+    {
+      question: '文本会被上传到服务器吗？',
+      answer: '不会。转换完全在您的浏览器本地进行。'
+    },
+    {
+      question: '支持嵌套列表吗？',
+      answer: '支持。系统会先解析列表语法树再生成目标格式。'
+    }
+  ],
+  howTo: [
+    {
+      name: '粘贴文本',
+      text: '粘贴 Steam BBCode、Markdown 或 HTML 文本。'
+    },
+    {
+      name: '自动转换',
+      text: '系统将自动生成另外两种格式。'
+    }
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Steam BBCode, Markdown 与 HTML 转换器',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'CNY' }
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: '文本会被上传到服务器吗？',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'จะไม่。转换完全在您的浏览器本地进行。'
+          }
+        }
+      ]
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: '如何转换 Steam BBCode、Markdown 与 HTML',
+      step: [
+        {
+          '@type': 'HowToStep',
+          name: '粘贴文本',
+          text: '粘贴 Steam BBCode、Markdown 或 HTML 文本。'
+        }
+      ]
+    }
+  ],
+  bibliography: bibliographyEntries
+};

package/src/tool/steamBbcodeTranslator/index.ts

@@ -0,0 +1,12 @@
+import type { ToolDefinition } from '../../types';
+import { steamBbcodeTranslator } from './entry';
+
+export * from './entry';
+export * from './logic';
+
+export const STEAM_BBCODE_TRANSLATOR_TOOL: ToolDefinition = {
+  entry: steamBbcodeTranslator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/steamBbcodeTranslator/logic.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest';
+import { detectSyntax, getPreviewHtml, markdownToBbcode, sampleBbcode, translate, translateToAll } from './logic';
+
+describe('steam BBCode translator', () => {
+  it('converts headings, inline emphasis and links to Markdown', () => {
+    const result = translate('[h1]Signal Lost[/h1]\n[b]Bold[/b] [url=https://example.com]Read[/url]', 'bbcode-to-output', 'markdown');
+    expect(result.output).toContain('# Signal Lost');
+    expect(result.output).toContain('**Bold**');
+    expect(result.output).toContain('[Read](https://example.com)');
+  });
+
+  it('keeps nested BBCode lists nested in Markdown and HTML', () => {
+    const markdown = translate('[list][*]Parent[list][*]Child[/list][*]Sibling[/list]', 'bbcode-to-output', 'markdown');
+    const html = translate('[list][*]Parent[list][*]Child[/list][*]Sibling[/list]', 'bbcode-to-output', 'html');
+    expect(markdown.output).toContain('- Parent\n  - Child');
+    expect(html.output).toContain('<ul><li>Parent<ul><li>Child</li></ul></li><li>Sibling</li></ul>');
+  });
+
+  it('translates Markdown list indentation back to Steam list tags', () => {
+    const result = markdownToBbcode('- Parent\n  - Child\n- Sibling');
+    expect(result.output).toBe('[list]\n[*]Parent\n[list]\n[*]Child\n[/list]\n[*]Sibling\n[/list]');
+  });
+
+  it('handles empty input and exposes a safe preview', () => {
+    expect(translate('   ', 'bbcode-to-output', 'html').stats.characters).toBe(0);
+    expect(getPreviewHtml(sampleBbcode, 'bbcode-to-output', 'html')).not.toContain('<script');
+  });
+
+  it('detects the pasted syntax and returns only the other two formats', () => {
+    expect(detectSyntax('[b]Steam[/b]')).toBe('bbcode');
+    expect(detectSyntax('# Markdown')).toBe('markdown');
+    expect(detectSyntax('<strong>HTML</strong>')).toBe('html');
+    expect(Object.keys(translateToAll(sampleBbcode).outputs).sort()).toEqual(['html', 'markdown']);
+  });
+
+  it('reports malformed closing tags without throwing', () => {
+    const result = translate('[b]Unfinished[/i]', 'bbcode-to-output', 'markdown');
+    expect(result.output).toContain('Unfinished');
+    expect(result.warnings.length).toBeGreaterThan(0);
+  });
+});

package/src/tool/steamBbcodeTranslator/logic.ts

@@ -0,0 +1,96 @@
+import type { AutoTranslationResult, MarkupSyntax, OutputFormat, TranslationDirection, TranslationResult } from './types';
+import { parseBbcode } from './bbcode-parser';
+import { renderHtml } from './html-renderer';
+import { renderMarkdown } from './markdown-renderer';
+import { htmlToBbcode } from './html-parser';
+import { markdownToBbcode } from './markdown-parser';
+
+export * from './types';
+export * from './storage';
+export { parseBbcode } from './bbcode-parser';
+export { renderMarkdown } from './markdown-renderer';
+export { renderHtml } from './html-renderer';
+export { htmlToBbcode } from './html-parser';
+export { markdownToBbcode } from './markdown-parser';
+
+function countBlocks(source: string): number {
+  return source.trim() ? source.split(/\n{2,}/).filter(Boolean).length : 0;
+}
+
+export function convertBbcode(source: string, format: OutputFormat): TranslationResult {
+  const parsed = parseBbcode(source);
+  const output = format === 'html' ? renderHtml(parsed.nodes) : renderMarkdown(parsed.nodes);
+  return {
+    output,
+    warnings: parsed.warnings,
+    stats: { characters: output.length, tags: parsed.tagCount, blocks: countBlocks(output) }
+  };
+}
+
+export function detectSyntax(source: string): MarkupSyntax {
+  const value = source.trim();
+  if (!value) return 'markdown';
+  if (/<(?:h[1-6]|p|strong|em|b|i|ul|ol|li|a|br|blockquote|code)\b[^>]*>/i.test(value)) return 'html';
+  if (/\[(?:\/?(?:h[1-3]|b|strong|i|em|u|s|strike|url|code|quote|spoiler|list|olist)|\*)[^\]]*\]/i.test(value)) return 'bbcode';
+  return 'markdown';
+}
+
+export function translate(source: string, direction: TranslationDirection, format: OutputFormat): TranslationResult {
+  if (!source.trim()) return { output: '', warnings: [], stats: { characters: 0, tags: 0, blocks: 0 } };
+  if (direction === 'bbcode-to-output') return convertBbcode(source, format);
+  if (format === 'html') return htmlToBbcode(source);
+  return markdownToBbcode(source);
+}
+
+function translateNonBbcode(source: string, detected: MarkupSyntax): AutoTranslationResult {
+  const bbcode = detected === 'html' ? htmlToBbcode(source) : markdownToBbcode(source);
+  const secondary = detected === 'html'
+    ? { markdown: convertBbcode(bbcode.output, 'markdown') }
+    : { html: convertBbcode(bbcode.output, 'html') };
+
+  return {
+    detected,
+    outputs: {
+      bbcode,
+      ...secondary
+    }
+  };
+}
+
+export function translateToAll(source: string): AutoTranslationResult {
+  const detected = detectSyntax(source);
+  if (!source.trim()) return { detected, outputs: {} };
+  if (detected === 'bbcode') {
+    return {
+      detected,
+      outputs: {
+        markdown: convertBbcode(source, 'markdown'),
+        html: convertBbcode(source, 'html')
+      }
+    };
+  }
+  return translateNonBbcode(source, detected);
+}
+
+export function getPreviewHtml(source: string, direction: TranslationDirection, format: OutputFormat): string {
+  if (!source.trim()) return '';
+  if (direction === 'bbcode-to-output') {
+    const result = translate(source, direction, format);
+    return format === 'html' ? result.output : convertBbcode(markdownToBbcode(result.output).output, 'html').output;
+  }
+  return convertBbcode(translate(source, direction, format).output, 'html').output;
+}
+
+export function getAutoPreviewHtml(source: string): string {
+  if (!source.trim()) return '';
+  const detected = detectSyntax(source);
+  if (detected === 'bbcode') return convertBbcode(source, 'html').output;
+  const bbcode = detected === 'html' ? htmlToBbcode(source).output : markdownToBbcode(source).output;
+  return convertBbcode(bbcode, 'html').output;
+}
+
+export const sampleBbcode = `[b]The Last Lantern[/b]\n\nA hand crafted survival adventure about a flooded city, a fragile airship, and the people you choose to rescue.\n\n[list][*]Scavenge abandoned districts[*]Upgrade your workshop[list][*]Solar engine[*]Deep water hull[/list][*]Make difficult choices[/list]\n\n[url=https://example.com/presskit]Read the press kit[/url]`;
+
+export const sampleMarkdown = `# The Last Lantern\n\n**A hand crafted survival adventure**\nExplore a flooded city, rebuild your airship, and choose who gets a place on board.\n\n- Scavenge abandoned districts\n- Upgrade your workshop\n  - Solar engine\n  - Deep water hull\n- Make difficult choices\n\n[Read the press kit](https://example.com/presskit)`;
+
+export const sampleHtml = `<h1>The Last Lantern</h1><p><strong>A hand crafted survival adventure</strong><br>Explore a flooded city, rebuild your airship, and choose who gets a place on board.</p><ul><li>Scavenge abandoned districts</li><li>Upgrade your workshop<ul><li>Solar engine</li><li>Deep water hull</li></ul></li><li>Make difficult choices</li></ul><a href="https://example.com/presskit">Read the press kit</a>`;

package/src/tool/steamBbcodeTranslator/markdown-parser.ts

@@ -0,0 +1,115 @@
+import type { TranslationResult } from './types';
+
+export function convertInlineMarkdown(value: string): string {
+  let output = value;
+  output = output.replace(/`([^`\n]+)`/g, '[code]$1[/code]');
+  output = output.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '$1');
+  output = output.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '[url=$2]$1[/url]');
+  output = output.replace(/\*\*([^*\n]+)\*\*/g, '[b]$1[/b]');
+  output = output.replace(/__([^_\n]+)__/g, '[b]$1[/b]');
+  output = output.replace(/~~([^~\n]+)~~/g, '[s]$1[/s]');
+  output = output.replace(/(?<!\*)\*([^*\n]+)\*(?!\*)/g, '[i]$1[/i]');
+  output = output.replace(/(?<!_)_([^_\n]+)_(?!_)/g, '[i]$1[/i]');
+  return output;
+}
+
+function countBlocks(source: string): number {
+  return source.trim() ? source.split(/\n{2,}/).filter(Boolean).length : 0;
+}
+
+interface ListState {
+  level: number;
+  orderedLevel: number;
+}
+
+function adjustListDepth(state: ListState, targetLevel: number, isOrdered: boolean, output: string[]): ListState {
+  let { level, orderedLevel } = state;
+  while (level > targetLevel) {
+    output.push(level === orderedLevel ? '[/olist]' : '[/list]');
+    if (level === orderedLevel) orderedLevel -= 1;
+    level -= 1;
+  }
+  while (level < targetLevel) {
+    level += 1;
+    if (isOrdered) orderedLevel = level;
+    output.push(isOrdered ? '[olist]' : '[list]');
+  }
+  return { level, orderedLevel };
+}
+
+function processListLine(state: ListState, listMatch: RegExpExecArray, output: string[]): ListState {
+  const indentStr = listMatch[1] ?? '';
+  const marker = listMatch[2] ?? '-';
+  const textContent = listMatch[3] ?? '';
+  const targetLevel = Math.floor(indentStr.length / 2);
+  const isOrdered = /\d+\./.test(marker);
+  const newState = adjustListDepth(state, targetLevel, isOrdered, output);
+  output.push(`[*]${convertInlineMarkdown(textContent)}`);
+  return newState;
+}
+
+function closeAllLists(state: ListState, output: string[]): ListState {
+  let { level, orderedLevel } = state;
+  while (level >= 0) {
+    output.push(level === orderedLevel ? '[/olist]' : '[/list]');
+    if (level === orderedLevel) orderedLevel -= 1;
+    level -= 1;
+  }
+  return { level: -1, orderedLevel: -1 };
+}
+
+function processCodeBlock(lines: string[], lineIndex: number, output: string[], warnings: string[]): number {
+  const codeLines: string[] = [];
+  let next = lineIndex + 1;
+  while (next < lines.length) {
+    const nextLine = lines[next];
+    if (nextLine && /^```/.test(nextLine)) break;
+    if (nextLine !== undefined) codeLines.push(nextLine);
+    next += 1;
+  }
+  if (next >= lines.length) warnings.push('An unclosed Markdown code fence was closed automatically.');
+  output.push(`[code]${codeLines.join('\n')}[/code]`);
+  return next;
+}
+
+function parseMarkdownLine(line: string, output: string[]): boolean {
+  const heading = /^(#{1,3})\s+(.+)$/.exec(line);
+  if (heading) {
+    const level = heading[1]?.length ?? 1;
+    output.push(`[h${level}]${convertInlineMarkdown(heading[2] ?? '')}[/h${level}]`);
+    return true;
+  }
+  const quote = /^>\s?(.*)$/.exec(line);
+  if (quote) {
+    output.push(`[quote]${convertInlineMarkdown(quote[1] ?? '')}[/quote]`);
+    return true;
+  }
+  return false;
+}
+
+export function markdownToBbcode(source: string): TranslationResult {
+  const lines = source.replace(/\r/g, '').split('\n');
+  const output: string[] = [];
+  const warnings: string[] = [];
+  let state: ListState = { level: -1, orderedLevel: -1 };
+
+  for (let idx = 0; idx < lines.length; idx += 1) {
+    const line = lines[idx] ?? '';
+    const listMatch = /^(\s*)([-+*]|\d+\.)\s+(.+)$/.exec(line);
+    if (listMatch) {
+      state = processListLine(state, listMatch, output);
+      continue;
+    }
+    state = closeAllLists(state, output);
+    if (!line.trim()) {
+      output.push('');
+    } else if (/^```/.test(line)) {
+      idx = processCodeBlock(lines, idx, output, warnings);
+    } else if (!parseMarkdownLine(line, output)) {
+      output.push(convertInlineMarkdown(line));
+    }
+  }
+  closeAllLists(state, output);
+  const result = output.join('\n').replace(/\n{3,}/g, '\n\n').trim();
+  return { output: result, warnings, stats: { characters: result.length, tags: (result.match(/\[[a-z*]/gi) ?? []).length, blocks: countBlocks(result) } };
+}