You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/features/references.md
+6-6Lines changed: 6 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -15,10 +15,10 @@ Targets are custom anchors that you can refer to elsewhere, for example, a figur
15
15
% TODO: name/label redundancy here would nice to be able to simplfy the onboarding (just use label, same as tex and mdast)
16
16
17
17
```{note}
18
-
There is different syntax for creating [Section/Header targets](targeting-headers) and ways to [label equations](targeting-equations) when using dollar math.
18
+
There is different syntax for creating [Section/Header targets](#targeting-headers) and ways to [label equations](#targeting-equations) when using dollar math.
19
19
```
20
20
21
-
Cross-referencing content is accomplished with markdown link syntax (`[text](link)`) or through specific roles ([ref](ref-role), [numref](numref-role), [eq](eq-role) or [doc](doc-role)), depending on your use-case.
21
+
Cross-referencing content is accomplished with markdown link syntax (`[text](#link)`) or through specific roles ([ref](#ref-role), [numref](#numref-role), [eq](#eq-role) or [doc](#doc-role)), depending on your use-case.
22
22
23
23
### Specification
24
24
@@ -36,17 +36,17 @@ Cross-referencing content is accomplished with markdown link syntax (`[text](lin
36
36
37
37
### Using Markdown Links
38
38
39
-
Using markdown link syntax is one of the most versatile ways to link to content. This uses the standard CommonMark syntax for a link (`[text](link)`), and the link can either be a label or a link to a document. For example:
39
+
Using markdown link syntax is one of the most versatile ways to link to content. This uses the standard CommonMark syntax for a link (`[text](#link)`), and the link can either be a label or a link to a document. For example:
40
40
41
41
````{list-table}
42
42
* - MyST Syntax
43
43
- Rendered
44
44
* - ```
45
45
[A **bolded _reference_** to a page](./references.md)
46
-
[A reference to a header](targeting-headers)
46
+
[A reference to a header](#targeting-headers)
47
47
```
48
48
- [A **bolded _reference_** to a page](./references.md)\
49
-
[A reference to a header](targeting-headers)
49
+
[A reference to a header](#targeting-headers)
50
50
````
51
51
52
52
```{note}
@@ -85,7 +85,7 @@ The `{numref}` role is exactly the same as the above `{ref}` role, but also allo
85
85
86
86
### Using the `{eq}` role
87
87
88
-
The `` {eq}`my-equation` `` syntax creates a numbered link to the equation, which is equivalent to `[](my-equation)` as there is no text content to fill in a title or caption.
88
+
The `` {eq}`my-equation` `` syntax creates a numbered link to the equation, which is equivalent to `[](#my-equation)` as there is no text content to fill in a title or caption.
89
89
90
90
% TODO: I think we should improve the syntax of links and simplify the explination
91
91
% It is annoying that numref and ref don't work for equations.
Copy file name to clipboardExpand all lines: docs/index.md
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,5 @@
1
1
# MyST Specification
2
2
3
-
```{warning}
4
-
`myst-spec` is in development; any structures or features present in the JSON schema may change at any time without notice.
5
-
```
6
-
7
3
MyST (Markedly Structured Text) is designed to create publication-quality, computational documents written entirely in Markdown. The main use case driving the development and design of MyST is [JupyterBook](https://jupyterbook.org/), which creates educational online textbooks and tutorials with Jupyter Notebooks and narrative content written in MyST.
8
4
9
5
## Overview
@@ -12,7 +8,7 @@ There are three components that this documentation and repository aims to formal
12
8
13
9
1. the MyST markup language, which is a superset of [CommonMark](https://commonmark.org/) (a standard form of Markdown);
14
10
2. the MyST abstract syntax tree (AST), which is the datastructure of a document after it has been parsed, and can be used in transforming and rendering content; and
15
-
3. a set of unittests that can be used to test implementations of MyST (e.g. in Python and Javascript).
11
+
3. a set of unit-tests that can be used to test implementations of MyST (e.g. in Python and Javascript).
16
12
17
13
## MyST Markup Language
18
14
@@ -40,4 +36,8 @@ Test cases are available for download here: https://unpkg.com/browse/myst-spec/d
40
36
41
37
## Working with the MyST AST
42
38
39
+
```{warning}
40
+
The `myst-spec` AST is in development; any structures or features present in the JSON schema may change at any time without notice.
41
+
```
42
+
43
43
This documentation contains all the node types used to construct a MyST document. Conventionally, the AST representation of a MyST document represents the state immediately after parsing. This means, for example, references are not resolved, directive/role structures are still present, etc. You may work with AST nodes by either modifying or adding to them to modify and update the corresponding MyST document, or you may transform and reduce them into a simpler structure to consume in other contexts.
0 commit comments