mdx-js / mdx

Markdown for the component era
https://mdxjs.com
MIT License
17.71k stars 1.14k forks source link

Pre-formatted text loses line breaks #1095

Closed pedrolamas closed 4 years ago

pedrolamas commented 4 years ago

Pre-formatted text loses line breaks

Multi-line text inside a <pre> block seems to loose line breaks.

Your environment

Steps to reproduce

On any markdown file, just add the following:

<pre>
line 1
line 2
</pre>

Expected behaviour

Expected rendered HTML to be:

<pre>
line 1
line 2
</pre>

Actual behaviour

Rendered HTML is:

<pre>line 1 line 2</pre>

So line breaks are missing!

viktor-yakubiv commented 4 years ago

I had a really brief look at this. In my case for some reason the example similar to yours:

` ` `
line 1
line 2
` ` `

<pre>
line 1
line 2
</pre>

renders pure markdown code syntax in <pre class="prism-code"> and the following <pre> becomes a <div>.

It may be possible that the issue is about general processing the HTML code.

pedrolamas commented 4 years ago

Indeed, that might actually be the case here... in my perspective HTML code should be maintained without any changes.

viktor-yakubiv commented 4 years ago

I cannot agree with the omitting HTML processing. There might be the case when you want to wrap the anchor element into the custom Link component that passes custom classes/attributes/event listeners to handle application routing.

I explored it a little bit more in the React Components tree, and the tree looks good apart from replaced newlines. My current assumption is that this happens at the MDAST transformation step (#2 from the doc).

pedrolamas commented 4 years ago

I created a small sandbox that shows the problem: https://codesandbox.io/s/pre-mdx-issue-69csw

pedrolamas commented 4 years ago

So this might not actually be an MDX issue... This screenshot is directly from babel website:

image

That is completely wrong for what was expected, but now I'm starting to question if I'm the one wrong here!

pedrolamas commented 4 years ago

I've opened a new issue on this matter with Babel as I now believe that is the source of the problem: https://github.com/babel/babel/issues/11678

wooorm commented 4 years ago

MDX is Markdown - HTML + JSX. This is JSX behavior. I don’t think it’s a bug with either MDX or Babel.

MDX is used to render to other targets too, such as CLIs, where it doesn’t make sense for h2 or pre to have special semantics.

wooorm commented 4 years ago

What is the reason you don’t use Markdown. Maybe this is an XY problem

line 1 line 2

pedrolamas commented 4 years ago

My interpretation was on the basis that HTML inside an markdown (.md file) file is maintained, but the same is not accurate for MDX (.mdx file) as the HTML is treated as JSX (so lines are collapsed and replaced with single space as per specification)

As for the reason to not use triple tick syntax was basically that all I have is a preformatted block, not actually code!

wooorm commented 4 years ago

I’d say go with an expression then. Not sure how it goes with MDX1, but MDX2 makes it more clear, e.g.:

<pre>
  {`line 1
line 2`}
</pre>
pedrolamas commented 4 years ago

@wooorm makes a good point, maybe I'm just trying to solve a problem that actually does not exist...

I will just move to triple backtick with "text" indication to skip highlighting!

I agree this is expected behavior for MDX (as inline HTML is supposed to be treated as JSX) so I will now close this issue.

viktor-yakubiv commented 4 years ago

Sorry, I accidentally raised this in the related issue expecting to do it here.

MDX is Markdown - HTML + JSX. This is JSX behavior. I don’t think it’s a bug with either MDX or Babel.

I agree with the conclusion, it definitely is not a bug. However, it matters what to choose for MDX: being JSX first or being HTML first.

wooorm commented 4 years ago

Yes it matters. MDX is JSX first.

pedrolamas commented 4 years ago

Yes it matters. MDX is JSX first.

Precisely, and that's what I should have remembered before I opened this bug in the first place...

derekm commented 2 years ago

@wooorm @pedrolamas @viktor-yakubiv -- How can I create a multi-line code block that contains MDX variable substitutions? I'm surprised this is so difficult in JSX.

wooorm commented 2 years ago

I don’t know what you’re looking for. I think it’s better if you open a new issue, read https://mdxjs.com/support/, and provide more info

derekm commented 2 years ago

Thanks, @wooorm!

I figured it out:

import versions from '@site/versions';
<pre><code>
{`wget https://github.com/pravega/pravega/releases/download/v${versions.pravega}/pravega-${versions.pravega}.tgz
# or
#curl -OL https://github.com/pravega/pravega/releases/download/v${versions.pravega}/pravega-${versions.pravega}.tgz
tar zxvf pravega-${versions.pravega}.tgz
cd pravega-${versions.pravega}`}
</code></pre>

Note the quoting expression:

{`...
...
...`}

and the $ on the bracketed variable substitutions (${...} instead of {...}).

Assuming a versions.js of:

const versions = Object.freeze({
  "pravega": "0.10.1",
});

export default versions;
lil5 commented 1 month ago

Just because jsx ignores page brakes shouldn't mean mdx can't add <br/> after every line inside a text block. Github's markdown does this too


This text contains line brake (no <br/>) in between the two words:

one two

Here's the html:

html

<p dir="auto">one<br>
two</p>
wooorm commented 1 month ago

This is 4 years old. Your comments are off topic. Follow support guidelines.