Introduction

Podlite is a lightweight markup language that's easy to learn and use. This quick tour will show you the most common features through practical examples.

Basic Structure

Headings

Headings are created using =head1, =head2, etc. The number indicates the heading level:

Paragraphs

Regular paragraphs are created by simply writing text. No special markers are needed:

This is a regular paragraph. It can contain multiple

Lists

Unordered Lists

Create bullet points using =item:

=item First item
=item Second item
=item Third item

Ordered Lists

Add :numbered to create numbered lists:

=for item :numbered
First item
=for item :numbered
Second item
=for item :numbered
Third item

Code Blocks

Show code examples using =code:

=begin code :lang<raku>
sub greet($name) {
    say "Hello, $name!";
}
=end code

Links

Create links using L<>:

Visit our L<website|https://example.com> for more information.

Images

Insert images using =picture:

=picture diagram.png
This is a diagram showing the system architecture.

Tables

Create tables using =table:

=begin table :caption<Programming Languages>
    Language    | Year Created | Creator
    ------------|--------------|----------
    Python      | 1991         | Guido van Rossum
    JavaScript  | 1995         | Brendan Eich
    Raku        | 2015         | Larry Wall
=end table

Text Formatting

Basic Formatting

B<Bold text> using B<>
I<Italic text> using I<>
C<Code text> using C<>

Special Characters

Use E<> for special characters:

E<copy> Copyright symbol
E<euro> Euro symbol
E<:smile:> Emoji

Notifications

Create attention-grabbing blocks using =nested with :notify:

=begin nested :notify<tip>
Remember to save your work frequently!
=end nested

=begin nested :notify<warning>
Be careful when deleting files!
=end nested

Mathematical Formulas

Include mathematical formulas using =formula:

=formula :caption<Quadratic Formula>
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}

Task Lists

Create checkboxes using =item with :checked:

=for item :checked
Completed task
=for item :!checked
Pending task

Advanced Features

Table of Contents

Generate a table of contents using =toc:

=toc head1, head2, head3

Including Files

Include other files using =include:

=include file:chapter1.pod6

Custom Blocks

Create custom blocks by using mixed-case names:

=begin CustomBlock
This is a custom block that can be processed
by specialized renderers.
=end CustomBlock

Best Practices

Next Steps

Now that you've seen the basics, you can:

• Read the full specification for complete details

• Try creating your own Podlite documents

• Explore more advanced features as needed