Skip to content

Commit

Permalink
Refactor prose
Browse files Browse the repository at this point in the history
  • Loading branch information
wooorm committed Oct 13, 2020
1 parent 1556753 commit 4f5f944
Showing 1 changed file with 7 additions and 13 deletions.
20 changes: 7 additions & 13 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@
**mdast** is a specification for representing Markdown in a [syntax
tree][syntax-tree].
It implements the [**unist**][unist] spec.
It can represent several flavours of [Markdown][], such as [CommonMark][],
and [GitHub Flavored Markdown][gfm] extensions.
It can represent several flavours of [Markdown][], such as [CommonMark][]
and [GitHub Flavored Markdown][gfm].

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

```idl
type FlowContent =
Blockquote | Code | Content | Heading | HTML | List | ThematicBreak
Blockquote | Code | Heading | HTML | List | ThematicBreak | Content
```

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

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

If a paragraph is present, it must be limited to one node and can only exist as
a [*tail*][term-tail].

### `ListContent`

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

```idl
type StaticPhrasingContent =
Text | Emphasis | Strong | HTML | InlineCode | Break | Image |
ImageReference
Break | Emphasis | HTML | Image | ImageReference | InlineCode | Strong | Text
```

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

### `TransparentContent`

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

## Extensions
Expand Down Expand Up @@ -1108,7 +1104,7 @@ accurate or no longer relevant.

**Delete** can be used where [**phrasing**][dfn-phrasing-content] content is
expected.
Its content model is also [**transparent**][dfn-transparent-content] content.
Its content model is [**transparent**][dfn-transparent-content] content.

For example, the following Markdown:

Expand Down Expand Up @@ -1594,8 +1590,6 @@ projects!

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

[term-tail]: https://github.com/syntax-tree/unist#tail

[dfn-mxn-resource]: #resource

[dfn-mxn-association]: #association
Expand Down

0 comments on commit 4f5f944

Please sign in to comment.