.. _tutorials:

Tutorials
=========

Choose your path to learning RSM.

.. grid:: 1 2 2 2

   .. grid-item-card:: 🎯 I want to try RSM now
      :class-card: sd-border-0

      **Use RSM Studio** (no installation)

      - Visit `rsm.studio <https://rsm.studio>`_
      - Start typing immediately
      - See output in real-time

      **Next**: Read :ref:`markup` (5 min) to learn basic syntax

   .. grid-item-card:: 📖 I want to learn RSM thoroughly
      :class-card: sd-border-0

      **Start with the feature tour**

      Essential concepts in order:

      1. :ref:`markup` - Basic syntax (5 min)
      2. :ref:`handrail` - Interactive UI (3 min)
      3. :ref:`tooltips` - Cross-references (5 min)
      4. :ref:`special` - Shortcuts (5 min)
      5. :ref:`styling` - CSS styling (5 min)
      6. :ref:`bibliography` - Citations (5 min)

      **Next**: :ref:`syntax` for complete reference

   .. grid-item-card:: 💻 I want to install RSM locally
      :class-card: sd-border-0

      **Local workflow** (for CLI users)

      Path:

      1. :ref:`installation` - Install RSM
      2. :ref:`first-manuscript` - Build your first doc
      3. :ref:`cli-commands` - Learn CLI options

      **Next**: Use ``rsm serve`` for live preview

   .. grid-item-card:: 🚀 I want to publish a paper
      :class-card: sd-border-0

      **Full publishing workflow**

      Path:

      1. Write manuscript in RSM (see :ref:`markup`)
      2. Run ``rsm build manuscript.rsm``
      3. Publish to `Scroll Press <https://scroll.press>`_ (see :ref:`publish-to-press`)

      **Next**: Check :ref:`example` for templates


All Tutorials
**************

.. toctree::
   :maxdepth: 1
   :caption: Feature Tour

   tutorials/markup
   tutorials/handrail
   tutorials/tooltips
   tutorials/special
   tutorials/styling
   tutorials/bibliography

.. toctree::
   :maxdepth: 1
   :caption: Reference & Examples

   tutorials/syntax
   tutorials/recipes
   tutorials/example

.. toctree::
   :maxdepth: 1
   :caption: Local Setup

   tutorials/installation
   tutorials/first-manuscript
   tutorials/cli-commands

.. toctree::
   :maxdepth: 1
   :caption: Publishing

   tutorials/publish-to-press