Skip to content

Unexpected behavior when rendering a main Markdown file (i.e. not imported or included) #974

@zapateo

Description

@zapateo

When running scriggo serve in a directory with an a.md file, I expected Scriggo to render that file as HTML.

Image

In reality, the Markdown isn't rendered and is kept as is, as if it were plain text:

Image

Discussing with @gazerro, it emerged that this is currently the expected behavior, because the Markdown file must be included from an HTML file or extended from an HTML file (if I understood correctly).

What to do

Option 1

Document the behavior, making it explicit when running scriggo help serve

Option 2

Make Scriggo also render Markdown files directly. This could be done by adding a minimal, unstyled HTML wrapper around them.

At that point, the user, if they wanted to add their own CSS style, intuitively understands that it's better to include the Markdown file from an HTML file (which defines the style) rather than rendering it directly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    needsDiscussionSomething that must be discussed before going ontemplatesRelated to the template

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions