README file from
GithubASCII Art Heading
Transform your headings into eye-catching ASCII art using FIGlet fonts.
Usage
Create a code block with the ascii-art language identifier:
```ascii-art
title: HELLO WORLD
```
Parameters
| Parameter | Description | Required |
|---|---|---|
title |
The text to render as ASCII art | Yes |
font |
FIGlet font name (see available fonts below) | No |
align |
Alignment: left, centre/center, right |
No |
colour |
Colour: hex code (#ff5500) or preset (accent, muted, warning, error, success) |
No |
Example with All Options
```ascii-art
title: FINANCIALS
font: Banner
align: centre
colour: #7c3aed
```
Available Fonts
- Standard (default)
- Banner
- Big
- Slant
- Small
- Block
- Doom
- Lean
- Mini
- Script
- Shadow
- Graffiti
- Ogre
- Poison
- Roman
- Speed
- Straight
Settings
Access settings via Settings → Community Plugins → ASCII Art Heading
- Default font - Font used when none specified in code block
- Font size - Tiny, Small, Normal, or Large
- Default colour - Theme default, accent, or custom hex colour
- Full width - Expand beyond readable line width
- Horizontal scroll - Enable scrolling for wide ASCII art (prevents wrapping)
- Show font name - Display font name below ASCII art
Installation
From Community Plugins
- Open Settings → Community Plugins
- Disable Safe Mode if prompted
- Click Browse and search for "ASCII Art Heading"
- Install and enable the plugin
Manual Installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest release - Create a folder called
ascii-art-headingin your.obsidian/plugins/directory - Copy the downloaded files into this folder
- Reload and enable the plugin in Settings → Community Plugins
Support
If you find this plugin useful, consider supporting its development:
License
MIT License - see LICENSE for details.
