This is an introduction paragraph with bold and italic text.
\n//\n//\n// const greet = () => \"Hello World!\"\n// inline codeAnother paragraph with strikethrough text.
` tags)\n- Select individual converters for specific use cases\n\n## Missing Functionality / Future Enhancements\n\nWhile Markup Converter provides core markdown conversion capabilities, there are several features that are **not yet implemented**:\n\n### š **Lists**\n- [ ] **Nested lists** - Currently only supports single-level lists\n- [ ] **Mixed list types** - Cannot mix ordered/unordered lists in same structure\n- [ ] **List items with multiple paragraphs** - Limited to single-line items\n\n### š **Links and Media**\n- [ ] **Links** - `[text](url)` syntax not supported\n- [ ] **Images** - `` syntax not supported\n\n### š **Advanced Formatting**\n- [ ] **Tables** - Markdown table syntax not supported\n- [ ] **Blockquotes** - `>` syntax for quoted text\n- [ ] **Horizontal rules** - `---` or `***` syntax\n- [ ] **Line breaks** - ` ` (double space) for `
` tags\n\n### šØ **Styling and Extensions**\n- [ ] **HTML attributes** - Class names, IDs, data attributes\n\n### āļø **Configuration**\n- [ ] **Custom converter options** - Configurable behavior per converter\n- [ ] **Output formatting** - Prettify output with indentation etc.\n\n### Workarounds\n\nFor missing functionality, consider:\n- **Links/Images**: Use raw HTML in your markdown\n- **Tables**: Convert to HTML table markup manually \n- **Advanced lists**: Structure as separate simple lists\n- **Blockquotes**: Use HTML `
` tags directly\n\n### Flexible Architecture\nYou can use the complete `MarkupConverter` for full markdown processing, or import individual converters to handle only specific formatting:\n\n```javascript\n// Full conversion pipeline\nimport { MarkupConverter } from '@an-eriksson/markup-converter'\n\n// Cherry-pick specific converters\nimport { HeadingConverter, InlineStyleConverter } from '@an-eriksson/markup-converter'\n```\n\nThis modular approach allows you to:\n- Build custom conversion pipelines\n- Handle specific markdown features in isolation\n\n### Available Converters\n\nThis library includes several specialized converters that can be used individually or together:\n\n### HeadingConverter\nConverts markdown headings to HTML heading tags.\n\n**Converts:**\n- `# Heading 1` ā `Heading 1
`\n- `## Heading 2` ā `Heading 2
`\n- `### Heading 3` ā `Heading 3
`\n\n### InlineStyleConverter\nHandles all inline text formatting within paragraphs and other content.\n\n**Converts:**\n- `**bold text**` ā `bold text`\n- `*italic text*` ā `italic text`\n- `~~strikethrough~~` ā `strikethrough`\n- `` `inline code` `` ā `inline code`\n\n### CodeBlockConverter\nConverts markdown code blocks to HTML pre and code elements.\n````markdown\n```\nfunction example() {\n return \"Hello World\"\n}\n```\n````\n\nā\n````html\n\n````\n\n### ListConverter\nConverts both ordered and unordered lists.\n\n**Converts:**\n```markdown\n- Item 1\n- Item 2\n- Item 3\n```\nā\n```html\n\nfunction example() {\n return \"Hello World\"\n}\n\n
\n```\n\n```markdown\n1. First item\n2. Second item\n3. Third item\n```\nā\n```html\n- Item 1
\n- Item 2
\n- Item 3
\n\n
\n```\n\n### ParagraphConverter\nWraps plain text blocks in paragraph tags while preserving other HTML elements.\n\n**Converts:**\n```markdown\nThis is a paragraph.\n\nThis is another paragraph.\n```\nā\n```html\n- First item
\n- Second item
\n- Third item
\nThis is a paragraph.
\n\nThis is another paragraph.
\n```\n\n## API Reference\n\n### MarkupConverter\n\n#### `constructor()`\nCreates a new MarkupConverter instance with all converters.\n\n#### `convert(text: string): string`\nConverts markdown text to HTML.\n\n**Parameters:**\n- `text` - The markdown text to convert\n\n**Returns:**\n- HTML string\n\n### Individual Converters\n\nAll converters extend `AbstractConverter` and implement the same interface:\n\n- `HeadingConverter` - Converts `# ## ###` to `
`\n- `CodeBlockConverter` - Converts code blocks to `
`\n- `InlineStyleConverter` - Converts `**bold**`, `*italic*`, `~~strikethrough~~`, `` `inline code` ``\n- `ListConverter` - Converts `- item` and `1. item` to `` and `
`\n- `ParagraphConverter` - Wraps plain text in `
` tags\n\n## Testing\n\nThis project uses a comprehensive testing approach:\n\n- **Unit Tests**: Individual converters are tested in isolation (`tests/*Converter.test.js`)\n- **Integration Tests**: The complete `MarkupConverter` pipeline is tested end-to-end (`tests/MarkupConverter.test.js`)\n\n```bash\nnpm test # Run all tests\nnpm run test:watch # Run tests in watch mode\n\n# Run specific test types\nnpm test -- tests/HeadingConverter.test.js # Unit tests for headings\nnpm test -- tests/CodeBlockConverter.test.js # Unit tests for code blocks\nnpm test -- tests/InlineStyleConverter.test.js # Unit tests for inline styles\nnpm test -- tests/ParagraphConverter.test.js # Unit tests for paragraphs\nnpm test -- tests/ListConverter.test.js # Unit tests for lists\nnpm test -- tests/MarkupConverter.test.js # Integration tests for full pipeline\n```","readmeFilename":"README.md"}