SKILLS/markdown-converter/SKILL.md

84 lines
1.9 KiB
Markdown

---
name: markdown-converter
description: A versatile Markdown conversion tool that supports converting Markdown to HTML, PNG images, and plain text formats.
metadata: {"clawdbot":{"emoji":"📝","os":["linux","darwin","win32"]}}
---
# Markdown Converter
A versatile Markdown conversion tool that supports converting Markdown to HTML, PNG images, and plain text formats.
## Features
- **HTML Conversion**: High-quality Markdown to HTML conversion
- **PNG Output**: Render Markdown as PNG images
- **CJK Support**: Uses system CJK fonts for Chinese character rendering
- **Code Highlighting**: Syntax highlighting for code blocks
- **Clean Output**: Removes invisible Unicode characters
## Installation
```bash
pip install matplotlib html2text pygments markdown
```
## Dependencies
- **matplotlib**: PNG image rendering with excellent CJK support
- **html2text**: HTML and Markdown conversion
- **Pygments**: Code syntax highlighting
- **markdown**: Python Markdown processor
## Usage
```bash
# Convert to HTML
python scripts/md_convert.py input.md output.html
# Convert to PNG
python scripts/md_convert.py input.md output.png
# Convert to plain text
python scripts/md_convert.py input.md output.txt
```
## Output Formats
### HTML
- Complete HTML document structure
- Inline CSS styling
- Code syntax highlighting
- Responsive design
### PNG Card
- White card background
- Large title font
- Automatic text wrapping
- CJK character support
### Plain Text
- Plain text output
- Preserves basic formatting
- Removes invisible characters
## Supported Platforms
- **Windows**: Uses system CJK fonts
- **macOS**: Uses PingFang and other system fonts
- **Linux**: Uses NotoSansCJK and other fonts
## Workflow
```
Markdown Input
[html2text / markdown library]
HTML / PNG / Plain Text
```
## Notes
- PNG rendering requires Chinese fonts to be installed on the system
- Code highlighting requires Pygments support
- Large files may require longer processing time