How to remove Snippet Section indent?

[maciejwalkowiak]

I have a following piece of code in file DynamoDbEnhancedClientTests.java:

public class DynamoDbEnhancedClientTests {

    @Test
    void createsClient() {
        // --8<-- [start:func]
        DynamoDbClient ddb = DynamoDbClient.builder()
                .region(Region.US_EAST_1)
                .build();
        // --8<-- [end:func]
    }
}

Now when I import func snippet:

--8<-- "DynamoDbEnhancedClientTests.java:func"

It gets rendered with exactly the same indentation as in the source file:

Is there an option to reduce the indentation (by the length of the indent in the first line) in each line so that the code is rendered like this:

Any help appreciated!

[facelessuser]

There is not currently a way to do so. Snippets is a fairly simple approach to injecting content from one file into another. Constant requests to make it a little more advanced have led us to sections 🙂. Sections are a fairly new feature. We could potentially consider adding some sort of dedent functionality, but at this time, I'm not quite sure what the syntax would even look like to make that happen...under the hood, it would be fairly easy to do so.

Now, snippets can be complex and even have nested snippets. If I were to add any kind of dedent functionality, I don't imagine I want to get too complicated and try to consider nested snippet context when dedenting, but if we are talking about a simple trigger to make a snippet get dedented, then I may be open to it.

[maciejwalkowiak]

Thank you for quick reply. I am new to Python Markdown world so I won't try to suggest how/if this should be done. Currently I solved it with an extra Javascript which is fine for my use case. For the reference:

const nodes = document.querySelectorAll("code")

nodes.forEach(node => {
    // skip nodes without multiple lines
    if (node.children.length > 1) {
        // [0] contains a line number
        // [1] contains first line of code
        let firstCodeLine = node.children[1];
        const hasPad = firstCodeLine.innerHTML.trim().length === 0
        // remove pad only from ones that have empty space before the code start
        if (hasPad) {
            const padLength = firstCodeLine.innerHTML.length;
            const paddingNodes = node.querySelectorAll("a + span.w")
            // remove pad from each line
            paddingNodes.forEach(pn => {
                pn.innerHTML = pn.innerHTML.substring(padLength);
            })
        }
    }
})

Then I include it in mkdocs.yml:

extra_javascript:
  - javascripts/extra.js

[chehsunliu]

I need this feature too. I just migrated to Material for MkDocs from Asciidoctor and docsify. They both support the dedent functionality. For now, I have to do some workaround.

[facelessuser]

There is no current planned path to resolve this at this time. Feel free to create a feature request. We will at least consider it as a possibility for the future.