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

GitBook is mangling formatting of the raw markdown #8

@bbatha

Description

@bbatha

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions