this post was submitted on 05 Mar 2025
5 points (100.0% liked)

FAQs

1 readers
6 users here now

Use this community for our frequently asked questions, how to use GeekRoom.Tech, how to navigate the Fediverse, and much more.

founded 17 hours ago
MODERATORS
5
Lemmy Formatting help (geekroom.tech)
submitted 15 hours ago* (last edited 12 hours ago) by [email protected] to c/[email protected]
 

Borrowing from @[email protected]'s post and @[email protected]'s post:

For anyone interested, here’s the Lemmy markdown configuration. As you can see, Lemmy’s website UI supports the full commonmark spec (tutorial / official spec), plus a bunch of extensions. I don’t think anyone’s fully documented these yet, so I’ll try doing so below. Apologies in advance to mobile users, this is probably gonna get ugly (see included image links for how it should look):


  • **bold**bold

  • *italics* OR _italics_italics

  • # Headings → # Headings (1 # for level1 heading, up to 5 #'s; must be at start of new line) [requires space between the #'s and the text]

  • [Link text](https://link.com/)Link text

  • Github-flavor Markdown extensions:

    • Tables
    • Strikethrough: ~~example~~ → ~~example~~
  • Subscript/Superscript:

    • Sub: example~sub~ → example~sub~
    • Super: example^super^ → example^super^
  • Footnotes:

    • Inline part: example[^notename or a number] → example[^1]
    • Bottom part: [^1]: My reference (must be placed at VERY end of post to work.)
  • Ruby Text: {example base text|example ruby text} → {example base text|example ruby text}

    • “Ruby” is an html-ism for special pronunciation aids which frequently appear within young person’s media where the language includes non-phonetic characters (e.g.: Chinese characters)
    • Japanese Furigana example: {凄|すご}い!→ 凄い!
  • Spoilers:

    
visible text hidden part example

visible texthidden part example

  • Code blocks:

`inline code` → inline code

code block:

 ```
 println(“Hello World!”)
 println("Line 2")
 ```

becomes

println(“Hello World!”)
println("Line 2")

OR

4 spaces at beginning of each line to be included in the code block becomes

this is a code block
line 2

Code Block Syntax Highlighting!

When after using the three backticks to start a code block, specify the language.

Rust:

    ``` rust
    // This is the main function
    fn main() {
        // Print text to the console
        println!("Hello World!");
    }
    ```

becomes:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

No language specified, defaults to "C" language:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

Text:

    ``` text
    // This is the main function
    fn main() {
        // Print text to the console
        println!("Hello World!");
    }
    ```

becomes:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

Python:

    ``` python
    // This is the main function
    fn main() {
        // Print text to the console
        println!("Hello World!");
    }
    ```

becomes:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

Finally:

If I want to write a character that will normally be interpreted as any of the above, I can escape the character with a backslash → \ ... So you can write something like \^this → ^this

[^1]: To make this footnote, I used the formatting defined above, preceding this text with "[^1]:"

you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 1 points 14 hours ago (1 children)

Thank you for the suggestions! I've updated the post with your recommendations and tried to make things more clear. If there's anything else you find is wrong or should be included, please let me know!

[–] [email protected] 2 points 13 hours ago (1 children)

Code block syntax highlighting! Without specifying the language, I think Lemmy treats all code blocks a C and applies syntax highlighting as such. Even when the code is obviously not C, or not even code at all, for that matter. Use text to explicitly not apply any highlighting.

``` rust
// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}
```
// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

No language specified:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

text:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}

python:

// This is the main function
fn main() {
    // Print text to the console
    println!("Hello World!");
}
[–] [email protected] 1 points 12 hours ago (1 children)

Thanks for this! I wasn't aware of this and appears that it was added because another popular instance had it but went down and never came back, leaving a massive gap in functionality.

[–] [email protected] 1 points 9 hours ago (1 children)

What do you mean by that? Not all Lemmy instances support it?

[–] [email protected] 1 points 8 hours ago* (last edited 7 hours ago)

So I was trying to get the syntax highlighting correct and when googling I came across a GitHub issue where someone said an old Lenny instance had syntax highlighting but it was a custom theme or something and Lenny at the time didn’t support it.

Then about a year and half ago the Lenny devs added native support for syntax highlighting.

References:

https://lemmy.ml/post/305136

Well, I can’t seem to find the original GitHub request for Lenny but the requester referenced either heapoverflow.info or heapoverflow.ml