Skip to content

[Feature Request] Adjust List indentation to follow github syntax(Fixed to four spaces) #33

@LazyRen

Description

@LazyRen

According to the Kramdown Syntax for Lists

The first list marker in a list may be indented up to three spaces. The column number of the first non-space character which appears after the list item marker on the same line specifies the indentation that has to be used for the following lines of content of the list item. If there is no such character, the indentation that needs to be used is four spaces or one tab. Indented lines may be followed by lines containing text with any amount of indentation due to line wrapping.

This means, if ordered list is (usually) used, list will take 3 spaces as the indentation for that list item.
for unordered list, it will be 2 spaces.

I'm wondering would it be possible for GFM (since it is default preprocessor for Jekyll - therefore github pages) to be matched with Github style? (consistent 4 spaces) Or at least provide option to it?

So for example, below markdown will print proper codeblocks with NO SPACE at the start of the codeblock.
But for the Kramdown with GFM preprocessor, codeblocks WILL HAVE unintended spaces at the start of the codeblock
(and I'm delibrately using 1. to show that they are from the same list)

Markdown:

1. First ordered item

    ```default
    Codeblock with one tab(four space) indentation
    ```

1. Second ordered item

   ```default
   Codeblock with **3 spaces** indentation
   ```

1. Third ordered item

* First unordered item

    ```default
    Codeblock with one tab(four space) indentation
    ```

* Second unordered item

  ```default
  Codeblock with **two spaces** indentation
  ```

* Third unordered item

Github Example: No space at the start of the codeblock

  1. First ordered item

    Codeblock with one tab(four space) indentation
    
  2. Second ordered item

    Codeblock with **3 spaces** indentation
    
  3. Third ordered item

  • First unordered item

    Codeblock with one tab(four space) indentation
    
  • Second unordered item

    Codeblock with **two spaces** indentation
    
  • Third unordered item

Jekyll Blog Example:

  • Screenshot

spaces

  • html
<ol>
  <li>
    <p>First ordered item</p>

    <pre><code class="language-default"> Codeblock with one tab(four space) indentation
</code></pre>
  </li>
  <li>
    <p>Second ordered item</p>

    <pre><code class="language-default">Codeblock with **3 spaces** indentation
</code></pre>
  </li>
  <li>
    <p>Third ordered item</p>
  </li>
</ol>

<ul>
  <li>
    <p>First unordered item</p>

    <pre><code class="language-default">  Codeblock with one tab(four space) indentation
</code></pre>
  </li>
  <li>
    <p>Second unordered item</p>

    <pre><code class="language-default">Codeblock with **two spaces** indentation
</code></pre>
  </li>
  <li>
    <p>Third unordered item</p>
  </li>
</ul>

Thank you.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions