Comments (10)
There is another issue connected with your offered solution, I.m Really sorry I can't provide it right now, I will leave a comment on Monday.
Thank you
from sphinx.
Without a blank line separating them lines are joined into a single line.
This isn't strictly true according to the Markdown spec regarding linebreaks:
To create a line break or new line (<br>), end a line with two or more spaces, and then type return.
The sample markdown snippet provided does include multi-spaces at the end of some of the lines, so it appears valid. What's TBD here is where (in terms of codebase) those newlines are being omitted, and what can be done about it.
from sphinx.
@jayaddison good catch! Also in the spec:
in nearly every Markdown application (, but itβs controversial)
Since this choice depends on the flavor I generally disregard it. Maybe Sphinx hasn't defined its Markdown flavor because it's originally a reST processor.
from sphinx.
You're not giving any reStructuredText or Markdown example file than can be tested. It would also help if you included a screenshot of the problem you're having. I'd never heard of the m2r but from you description I'm guessing there's something wrong in the transformation step from md to rst.
Also the sphinxcontrib-confluencebuilder has their own active issues page, I think you're likely to get a quicker response if you post there and they help figuring out what's wrong.
from sphinx.
MarkDown envvars.md
What we expect
Result in Confluence
from sphinx.
You're not giving any reStructuredText or Markdown example file than can be tested. It would also help if you included a screenshot of the problem you're having. I'd never heard of the m2r but from you description I'm guessing there's something wrong in the transformation step from md to rst.
Also the sphinxcontrib-confluencebuilder has their own active issues page, I think you're likely to get a quicker response if you post there and they help figuring out what's wrong.
I will also write them
from sphinx.
I think your .md
is wrong because a paragraph needs to be separated by a blank line, see:
To create paragraphs, use a blank line to separate one or more lines of text.
Without a blank line separating them lines are joined into a single line. Also get rid of the <br>
with Markdown you're supposed to use a blank line instead of it.
from sphinx.
AFAIK, we expect valid RST content and not just markdown content. Since the issue stems from a 3rd party extension, I am closing this one (this repo is only meant for core issues and not non-native extensions). I think the issue should be reported to myst_parser
or m2r
instead.
from sphinx.
@sargis2000 myst-parser follows commonmark, it is recommended to use \
hard line breaks.
You can see this working in https://myst-parser.readthedocs.io/en/latest/live-preview.html π
from sphinx.
@sargis2000 myst-parser follows commonmark, it is recommended to use
\
hard line breaks. You can see this working in https://myst-parser.readthedocs.io/en/latest/live-preview.html π
Hi @chrisjsewell , it doesnt work for Attlasian Confluence.
from sphinx.
Related Issues (20)
- Force multi-line rendering of signatures at the directive level.
- [tracker] Issues related to autodoc and "undefined reference" HOT 2
- Autosummary shows function signature in modules group when importing function of same name
- Recursive autosummary does not pass all options
- Config option `python_display_short_literal_types` not working HOT 1
- Minify css and js HOT 2
- Autosummary lists functions but does not generate documentation pages HOT 3
- `objects.inv` is not generated deterministically when there are duplicate references HOT 3
- add_css = getattr(app, "add_css_file", app.add_stylesheet) HOT 3
- <short description for the feature>
- Unify docutils type annotations HOT 10
- Intersphinx cannot link to section headers with uppercase names HOT 8
- Add toc entry autofunction
- pre_border-radius not translating to latexpdf for .. warning HOT 7
- Imported string constant has wrong docstring of `str` HOT 3
- In autosummary, expose complete objtype information to templates
- Sphinx Viewcode.py IndexError list index out of range if child class file (.py) is smaller than parent class file. HOT 5
- Test suite: search: test fixture does not accurately represent the JS search index format HOT 2
- linkcheck inconsistent behavior from client HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
π Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. πππ
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google β€οΈ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from sphinx.