update README and docs

Author: wenh06

README.md

@@ -31,8 +31,8 @@ extensions = [
 ]
 
 # -------------------------- Optional Configuration --------------------------
-# 1. Specify math engine (default: "mathjax3", alternative: "katex")
-pseudocode2_math_engine = "mathjax3"
+# 1. Specify math engine (default: "katex", alternative: "mathjax3")
+pseudocode2_math_engine = "katex"
 
 # 2. Global pseudocode.js configuration (pseudocode2_options)
 #    All parameters are directly passed to pseudocode.renderClass()

docs/source/index.rst

@@ -55,6 +55,31 @@ Pseudocode rendering is extended with practical options (all compatible with pse
 - ``scopelines``: Highlight scope lines (those with control block starters like IF, FOR, WHILE, etc.)
 - ``no-scopelines``: Disable scope line highlighting
 
+Typical usage example:
+
+.. code-block:: rst
+
+    .. pcode::
+        :linenos:
+        :indent: 1.5em
+        :comment-delimiter: "#"
+        :line-number-punc: " | "
+        :no-end:
+        :title-prefix: "PseudoCode"
+        :scopelines:
+
+        \begin{algorithm}
+        \caption{My Sample Algorithm}
+        \begin{algorithmic}
+        \STATE Initialize variables
+        \FOR{each item in list}
+            \IF{item is valid}
+                \STATE Process item  # This is a comment
+            \ENDIF
+        \ENDFOR
+        \end{algorithmic}
+        \end{algorithm}
+
 Global Configuration via ``pseudocode2_options``
 =====================================================
 
@@ -74,6 +99,12 @@ Pseudocode rendering styles can be unified across the entire project using a sin
 **Priority Rule**:
 Configuration priority (higher priority overrides lower): Directive option (e.g., :linenos: in .rst) > pseudocode2_options (global in conf.py) > pseudocode.js default
 
+Another configurable option is ``pseudocode2_math_engine`` (set in `conf.py`), which specifies the math rendering engine to use (either ``"katex"`` or ``"mathjax3"``; default is ``"katex"``):
+
+.. code-block:: python
+
+    pseudocode2_math_engine = "katex"  # or "mathjax3"
+
 Tips
 =====================================================