Skip to content
This repository has been archived by the owner on Apr 11, 2022. It is now read-only.

GitBook is mangling formatting of the raw markdown #8

Open
bbatha opened this issue Mar 29, 2019 · 0 comments
Open

GitBook is mangling formatting of the raw markdown #8

bbatha opened this issue Mar 29, 2019 · 0 comments

Comments

@bbatha
Copy link
Contributor

bbatha commented Mar 29, 2019

See 6adf42c for an example.

When writing markdown files it good to insert a line break into the source file after any major punctuation (".", ";", ":"). This makes diffing the source text much easier, because if you have entire paragraphs on a single line you need to read the whole paragraph for differences.

GitBook is also making the history harder to read for a file and ultimately figureout who made the change.

Possibly we should have a branch for the raw sources and a seperate branch that has gitbook normalized files.

This behavior can also lead to suprisingly rendered files such as:

image

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant