tree-sitter-org 0.24.0

#+TITLE: Tree-Sitter Org-Mode parser

* Overview
This project implements a Tree-Sitter-based parser for Emacs Org-Mode files.

The long-term goal is high fidelity and eventually 100% feature coverage, while
keeping robust error recovery and useful parse trees for downstream processing.

* Supported features
Parsing [[examples/showcase.org][this file]] results in [[examples/showcase.tree-sitter][the following parse tree]].
See the other [[file:examples/][example files]] to get a better idea what this parser can parse.

* Gotchas
- Table.el tables parse as verbatim blocks of text. Their contents are inaccessible.
- Malformed objects are usually treated as plaintext or recovered with generic
  parse-error nodes.

* Explicitly Not Supported
- Inline tasks are not represented as a dedicated node type,
  they are treated as regular headings.
- Sexp timestamps (like =<%%(...)>=) are not parsed as regular timestamp nodes,
  they are plain text instead.
- LaTeX fragments & environments are not parsed as structured Org objects,
  they are plain text instead.

* Roadmap
See [[file:ROADMAP.org][ROADMAP.org]] for planned work and milestone history.