Skip to content

Commit b8d71d8

Browse files
authored
docs: document how to use dargs sphinx directive in markdown files (#77)
inspired by deepmodeling/deepmd-kit#3989 <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit - **Documentation** - Added a code snippet for writing Markdown files using MyST-Parser in the documentation. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
1 parent 7c18715 commit b8d71d8

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/sphinx.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,16 @@ A :class:`list` of :class:`Argument <dargs.Argument>` is also accepted.
3030
:module: dargs._test
3131
:func: test_arguments
3232

33+
To write Markdown files with `MyST-Parser <https://github.com/executablebooks/MyST-parser>`_, one can use:
34+
35+
.. code-block:: markdown
36+
37+
```{eval-rst}
38+
.. dargs::
39+
:module: dargs._test
40+
:func: test_argument
41+
```
42+
3343
Cross-referencing Arguments
3444
---------------------------
3545

0 commit comments

Comments
 (0)