I'm excited to introduce a new markup language called [Podlite](https://podlite.org/specification). It's designed to make  documentation, blogging, educational materials, and much more, a breeze to create and manage.


Introducing Podlite, a lightweight block-based markup language


TITLE

DESCRIPTION

root

markdown

=begin markdown

 Hey everyone! 🚀

I'm excited to introduce a new markup language called [Podlite](https://podlite.org/specification). It's designed to make  documentation, blogging, educational materials, and much more, a breeze to create and manage.

**Key features of Podlite include:**

* **Blocks as the basic unit:** Each document is built from blocks, which are the basic units that can have their own defined attributes.
* **Flexible linking:** Link blocks together in various relationships.
* **Formula support:** Perfect for academic and scientific documentation.
* **Markdown support:** Love Markdown? Podlite does too. It includes a standard block for Markdown, so you can switch modes seamlessly.
* **Rich content support:** Tables, images, table of contents, and all sorts of lists are all supported.
* **Extensibility:** Extend Podlite with your own custom blocks and inline codes to fit your needs

Podlite doesn't adhere to any specific programming language. This allows it **to be embedded** in any programming language that supports block-level comments, or multi-line comments.

**For example, in JavaScript:**

    /*
    =head1 Documentation
    
    =begin Mermaid
    graph LR
            A-->B
            B-->C
            C-->A
            D-->C
    =end Mermaid
    =begin markdown
    
    # header
    
     * text
     * text
    
    =end markdown
    */

[open this sample at pod6.in](https://pod6.in/#p=%3Dhead1+Documentation%0A%0AThis+is+a+general+overview%3A%0A%0A%3Dbegin+Mermaid%0Agraph+LR%0A++++++++A--%3EB%0A++++++++B--%3EC%0A++++++++C--%3EA%0A++++++++D--%3EC%0A%3Dend+Mermaid%0A%3Dbegin+markdown%0A%0A%23+header%0A%0A+*+text%0A+*+text%0A%0A%3Dend+markdown)

Blocks can be represented in three equivalent forms: **delimited** style, **paragraph** style, and **abbreviated** style.

    =begin table :caption<Summary>
      Constants           1
      Variables           10
    =end table
    
    =for table :caption<Summary>
      Constants           1
      Variables           10
    
    =table
      Constants           1
      Variables           10

[open this sample at pod6.in](https://pod6.in/#p=%0A%3Dbegin+table++%3Acaption%3CSummary%3E%0A++Constants+++++++++++1%0A++Variables+++++++++++10%0A%3Dend+table%0A%0A%3Dfor+table+%3Acaption%3CSummary%3E%0A++Constants+++++++++++1%0A++Variables+++++++++++10%0A%0A%3Dtable%0A++Constants+++++++++++1%0A++Variables+++++++++++10%0A)

Podlite is perfect for creating documentation, blogs, educational materials, and much more.

**Current status of Podlite:**

* currently in **beta**, with ongoing work for the next version.
* there's a [reference implementation](https://github.com/podlite/podlite) driving [web publishing package](https://github.com/podlite/podlite-web)  and [a web editor](https://pod6.in) .
* and yes, there's an editor/viewer for desktop too: https://github.com/podlite/podlite-desktop.

This is an early announcement to gauge interest in this markup language.

**Find out more:**

* Specification : [https://github.com/podlite/podlite-specs](https://github.com/podlite/podlite-specs), [\[in html format\]](https://podlite.org/specification)
* github:  [https://github.com/podlite](https://github.com/podlite) ⭐️
* website: [https://podlite.org](https://podlite.org)
* web playground: [https://pod6.in](https://pod6.in)

[The Podlite specification](https://github.com/podlite/podlite-specs/blob/main/Specification.pod6) is published under the Artistic license 2.0.

I'd be incredibly grateful for any feedback and ideas.

Thank you so much for your time!

Best regards, 
Alex

=end markdown


Podlite, a lightweight block-oriented markup language that's all about flexibility and ease of use. 


Podlite has introduced a range of new features designed to enhance the flexibility and usability of the markup language.


This release of Podlite introduces significant enhancements aimed at improving the flexibility, customization, and user interaction of the markup language. With the addition of new blocks, attributes, and support for rich media, Podlite is better equipped to handle a variety of documentation needs. Concurrently, the deprecation and removal of certain features have simplified the toolset, reducing overlap and enhancing user experience. These changes reflect a commitment to the continuous improvement of Podlite, ensuring it remains a versatile and powerful tool for content creators.


picture

=begin markdown

## What is Podlite?

[Podlite](https://podlite.org), a lightweight block-oriented markup language that's all about flexibility and ease of use. 

* Unbound by any specific domain, programming language, or concept, Podlite stands out as a universal markup language

* In addition, the support for Markdown markup as a standard block adds convenience and allows for the use of familiar syntax for text formatting

* It's perfect for documentation, educational materials, blogging, and much more for organizing knowledge.

* One of the key features of Podlite is its extensibility. This allows for defining unique and domain-specific blocks and expanding the language's functionality according to the requirements of your project.

* [The Podlite specification](https://github.com/podlite/podlite-specs) is published under the Artistic license 2.0.


## Key Features of Podlite

- **Block-based structure:** At the core of Podlite is the concept of "blocks," which are the fundamental units of any document. These blocks can have defined attributes and support the inclusion of rich content.
  
- **Rich linking capabilities:** Podlite allows blocks, terms, definitions to be linked with various types of relationships, enhancing the interconnectivity and navigability of your documents.
  
- **Support for formulas and Markdown:** Whether you need to insert complex mathematical formulas or prefer the simplicity of Markdown, Podlite has you covered. It seamlessly integrates both, giving you the flexibility to choose how you want to write.
  
- **Extensible and customizable:** Extend Podlite with custom blocks and inline codes, tailoring the language to meet your specific needs.


## Podlite v1.0 Release Notes

Podlite has introduced a range of new features designed to enhance the flexibility and usability of the markup language:


### Customization and Extensibility
   
   - **Refactoring of Custom blocks:** Enhanced customization through refactored named custom blocks.
   
   - **Inline Markup extension:** `M<>` now extends inline markup features, allowing for more expressive text formatting.
   

### Processing and data handling

   - **Markdown support:** The `=markdown` block is now a standard block. Integration of a new markdown mode for the parser.
   
   - **MIME type specification:** Added `:mime-type` attribute for `=include` and `=data` blocks, facilitating better handling of diverse data types.
      
   - **Data schema introduction:** Implemented `data:` schema for use in `=picture` and `=table` blocks, simplifying data embedding.
      
   - **Embedding binary data:** Support for embedding binary data directly into documents with `:filename` and `:encoding` attributes in `=data` blocks.
   
   - **CSV tables:** Capability to render tables directly from CSV files with the enhanced `=table` block.

### Content Structuring and Navigation
   
   - **Selectors:** Introduced selectors for dynamic content interaction and manipulation.
   
   - **Comprehensive TOC:** Enhanced `=toc` block for generating detailed tables of contents.
   
   - **Including external content:** New `=include` block for incorporating external files and documents seamlessly.
  
   - **Advanced table formatting:** New `=row` and `=cell` blocks with `:header`, `:rowspan`, and `:colspan` attributes for intricate table designs.
     
   - **Additional attributes for linking:** Addition of `:id`, `:caption`, and `:lang` attributes to enrich document metadata and accessibility.
         
   - **Contextual backlinks:** `W<>` for creating contextual backlinks, enhancing document navigation and reference capabilities.
   
   - **Foldable content:** New `:folded` attribute to toggle visibility of content, and `:folded-levels` for nested visibility control in table of contents (TOC) blocks.

   

### Document Presentation Enhancements

   - **Notification blocks:** Introduced notification blocks with a `:notify` attribute, improving interactivity within documents.
   
   
   - **Task lists:** Introduction of task lists with the `=item` block and a `:checked` attribute to manage to-do items effectively.
    
   - **Mistake marking:** Introduced `O<>` for highlighting and marking mistakes, useful in educational and review settings.
   
   - **Text positioning:** New attributes `J<>` for justifying and `H<>` for horizontal positioning of text.
   
   - **Emojis:** Added support for emojis with `E<>`, enriching the expressiveness of documents.
   
   - **Picture insertions:** New features in the `=picture` block and `P<>` for improved image handling.
   
   - **Mathematical formulas:** Enhanced support for complex mathematical formulas with `=formula` and `F<>`.


### Deprecated/removed

With the introduction of new functionalities, certain features have been deprecated or removed to streamline Podlite:

-   `P<toc:>` due to `=toc` block,

-   `P<man:>`, `P<doc:>` due to `=include` block,

-   `:margin` attribute, `=encoding` directive, Declarator block been removed due to redundancy.

-   Contextual aliases, the `=finish` directive, and markers in comments, `P<>` - placement links, `:formatted` attribute, `:like` attribute have been removed due to redundancy and enhancements in other areas.


## Summary of Release

This release of Podlite introduces significant enhancements aimed at improving the flexibility, customization, and user interaction of the markup language. With the addition of new blocks, attributes, and support for rich media, Podlite is better equipped to handle a variety of documentation needs.

Concurrently, the deprecation and removal of certain features have simplified the toolset, reducing overlap and enhancing user experience. These changes reflect a commitment to the continuous improvement of Podlite, ensuring it remains a versatile and powerful tool for content creators.


## Feedback and Contributions

Feedback is encouraged and can be provided through [Github Discussions](https://github.com/podlite/podlite-specs/discussions). This input is crucial for the ongoing development and enhancement of Podlite.

**Thank You!**

**Find out more:**

* Specification : [https://github.com/podlite/podlite-specs](https://github.com/podlite/podlite-specs), [\[in html format\]](https://podlite.org/specification)

* Website: [https://podlite.org](https://podlite.org)
* Web playground: [https://pod6.in](https://pod6.in)
* Github:  [https://github.com/podlite](https://github.com/podlite) ⭐️


**Stay tuned for more updates and happy documenting!**
=end markdown
