Discord
Login
Community
DARK THEME

Use markdown in forum posts and replies

Markdown is a simple syntax to add formatting to your text. You can find a complete markdown cheat sheet here

Here are a few basics, I am displaying the code first and then the result:

# Title
## Sub-title
### Sub-sub-title

Title

Sub-title

Sub-sub-title


List:
* item 1
* item 2
* item 3

List:

  • item 1
  • item 2
  • item 3

Some paragraph of text

Some other paragraph *with some text in italics*

Some other paragraph **with some text in bold**

Some paragraph of text

Some other paragraph with some text in italics

Some other paragraph with some text in bold

Note: bold characters do not look like bold for now due to a font problem ; I will make sure to fix that


A paragraph, then a code block

```
x = x+1
myFunction()
```

A paragraph, then a code block

x = x+1
myFunction()

I can also format inline code within my paragraph like this ```screen.drawText()```, how cute is that?

I can also format inline code within my paragraph like this screen.drawText(), how cute is that?


You can make tables like this:

|column 1|column 2|
|-|-|
|whatever|something|
|something else|and whatnot|

You can make tables like this:

column 1 column 2
whatever something
something else and whatnot

I tried all markup variations I know trying to embed image links into my posts. Funny thing, they show in preview mode, but not in the posted message.

In my TinkerShed post I even tried an iframe (embedded a playable link to my project into it). Same, works in preview but disappears in the final post. Still there and working in edit mode though...

Could we 'pretty please' have embedded images? Would make it so much easier to explain stuff sometimes.

I will be thinking about it. Ideally, I would like to allow dropping images to the editing window and have them hosted on microstudio.dev, rather than allowing links to external images. However I will see what I can do effectively to enable this. When working on the initial release of the forum, I figured it would still be possible to draw a diagram using this site: https://asciiflow.com/ :-)

Oh, this is nice! I'd found out about the markup one, but I didn't know about all the others! Although I feel like I get it wrong and have to look at the preview....

Yeah, embedded images (or maybe just copying images) would be nice, although it's still fine to explain stuff without it, anyways

This post ought to be linked to the bottom (middle) of all reply boxes. That way it's easy to find what the markdown options are. All that happens now is that a reply box says, "you can use markdown" but with no actual details as to what that means.

I also suggest this is tagged under HELP too.

some where i already saw an embedded image, how to do that?

please make it possible to attach your own images and it would also be nice to be able to make spoilers in messages.

this is how it is inconvenient to attach images, but so far there is no alternative, I do it this way

<picture>
  <img src="the link to the image in quotes">
</picture>

(ADDED) And using :embedded URL

For example

:embedded https://microstudio.io/Romero/serialportapiformicroscript/ you can add your project right here, but it will work in protected mode, as in the preview in the code editor. my demo from SerialPort won't work here, it will only work in a new tab.

:embed https://microstudio.io/Romero/serialportapiformicroscript/

thank you Romero

For your Web Serial project and other projects that need special permissions, you can detect if the window is embedded.

//javascript
global.is_embedded = function() {
  return window.parent == window;
}
init = function()
  if is_embedded() then
    system.say("Please open the project in a new tab")
  end
end

thanks @TwiceUponATime

thanks :)

Post a reply

Progress

Status

Preview
Cancel
Post
Validate your e-mail address to participate in the community