Skip to content

Commit 4f5f944

Browse files
committed
Refactor prose
1 parent 1556753 commit 4f5f944

File tree

1 file changed

+7
-13
lines changed

1 file changed

+7
-13
lines changed

Diff for: readme.md

+7-13
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@
77
**mdast** is a specification for representing Markdown in a [syntax
88
tree][syntax-tree].
99
It implements the [**unist**][unist] spec.
10-
It can represent several flavours of [Markdown][], such as [CommonMark][],
11-
and [GitHub Flavored Markdown][gfm] extensions.
10+
It can represent several flavours of [Markdown][], such as [CommonMark][]
11+
and [GitHub Flavored Markdown][gfm].
1212

1313
This document may not be released.
1414
See [releases][] for released documents.
@@ -918,7 +918,7 @@ nodes with similar characteristics together.
918918

919919
```idl
920920
type FlowContent =
921-
Blockquote | Code | Content | Heading | HTML | List | ThematicBreak
921+
Blockquote | Code | Heading | HTML | List | ThematicBreak | Content
922922
```
923923

924924
**Flow** content represent the sections of document.
@@ -931,9 +931,6 @@ type Content = Definition | Paragraph
931931

932932
**Content** represents runs of text that form definitions and paragraphs.
933933

934-
If a paragraph is present, it must be limited to one node and can only exist as
935-
a [*tail*][term-tail].
936-
937934
### `ListContent`
938935

939936
```idl
@@ -954,17 +951,16 @@ type PhrasingContent = Link | LinkReference | StaticPhrasingContent
954951

955952
```idl
956953
type StaticPhrasingContent =
957-
Text | Emphasis | Strong | HTML | InlineCode | Break | Image |
958-
ImageReference
954+
Break | Emphasis | HTML | Image | ImageReference | InlineCode | Strong | Text
959955
```
960956

961957
**StaticPhrasing** content represent the text in a document, and its
962958
markup, that is not intended for user interaction.
963959

964960
### `TransparentContent`
965961

966-
The content model of a transparent node is derived from its [parent][dfn-parent]
967-
node.
962+
The **transparent** content model is derived from the content model of its
963+
[parent][dfn-parent].
968964
Effectively, this is used to prohibit nested links (and link references).
969965

970966
## Extensions
@@ -1108,7 +1104,7 @@ accurate or no longer relevant.
11081104

11091105
**Delete** can be used where [**phrasing**][dfn-phrasing-content] content is
11101106
expected.
1111-
Its content model is also [**transparent**][dfn-transparent-content] content.
1107+
Its content model is [**transparent**][dfn-transparent-content] content.
11121108

11131109
For example, the following Markdown:
11141110

@@ -1594,8 +1590,6 @@ projects!
15941590

15951591
[term-head]: https://github.com/syntax-tree/unist#head
15961592

1597-
[term-tail]: https://github.com/syntax-tree/unist#tail
1598-
15991593
[dfn-mxn-resource]: #resource
16001594

16011595
[dfn-mxn-association]: #association

0 commit comments

Comments
 (0)