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
{{ message }}
This repository has been archived by the owner on Apr 23, 2020. It is now read-only.
A paragraph is simply one or more consecutive lines of text, separated by one or
more blank lines. (A blank line is any line that looks like a blank line - a
line containing nothing but spaces or tabs is considered blank.) Normal
paragraphs should not be indented with spaces or tabs.
The implication of the "one or more consecutive lines of text" rule is that
Markdown supports "hard-wrapped" text paragraphs. This differs significantly
from most other text-to-HTML formatters (including Movable Type's "Convert Line
Breaks" option) which translate every line break character in a paragraph into a <br /> tag.
When you do want to insert a <br /> break tag using Markdown, you end a line
with two or more spaces, then type return.
Yes, this takes a tad more effort to create a <br />, but a simplistic "every
line break is a <br />" rule wouldn't work for Markdown. Markdown's email-style
blockquoting and multi-paragraph list items work best - and look better - when
you format them with hard breaks.
For an example, see a Markdown in a file whose text paragraphs are wrapped at 79 characters
note the line endings in the "Description" section are exactly the same in .md and html instead of the html wrapping based on the width of the browser window.
It appears that grommet renders all line breaks in .md files, despite the Markdown specification spelling out how this behavior should work (https://daringfireball.net/projects/markdown/syntax#p)
For an example, see a Markdown in a file whose text paragraphs are wrapped at 79 characters
http://git.openswitch.net/cgit/openswitch/ops/tree/docs/access_list_cli.md#n45
compared to the website rendered via grommet whose paragraphs are also (incorrectly) wrapped at the same 79 characters
http://www.openswitch.net/documents/user/access_list_cli#description
note the line endings in the "Description" section are exactly the same in .md and html instead of the html wrapping based on the width of the browser window.
(Transferred from grommet/grommet#624)
The text was updated successfully, but these errors were encountered: