FORMATTING HOWTO: apiaristic marking in all directions #556

  meta good
citrons (bureaucrat) (edited ) src #5047/1

welcome to apioforum. the first thing you might wonder is, "how might my text be so...

rich?

it's simple. it's all so, all so simple.

when you post on apioforum, you compose the source of the post, which is translated into how it finally appears. to view the source of any post, such as this one, click the [src] link.


common markdown features

you might be familiar with the concept of markdown. you are very intelligent, so I wouldn't be surprised if you already knew how to perform basic formatting already.

you have you get
*I'm italic* I'm italic
**I'm bold** I'm bold
***I'm bold and italic*** I'm bold and italic

# heading

## subheading

### subsubheading

heading

subheading

subsubheading

`I'm code`
I'm code

```

int main() {

   printf("I'm a multiline code block\n");

}

```

int main() {
    printf("I'm a multiline code block\n");
}
> I'm a blockquote
I'm a blockquote

* this

* list

* is

* bulleted

  • this
  • list
  • is
  • bulleted

1. this

2. list

3. is

4. numbered

  1. this
  2. list
  3. is
  4. numbered
[I'm a link to example.com](https://example.com) I'm a link to example.com
<https://example.com> https://example.com
![an image of my home server](https://citrons.xyz/static/woman1.jpg) an image of my home server

and that's how I defrauded the shareholders.

---

anyway,

and that's how I defrauded the shareholders


anyway,

advanced markdown technology

this markdown is equipped with some strange (and useful) extra features as well.

you have you get

??? "I have a secret"

    just kidding. I would never have secrets

I have a secret

just kidding. I would never have secrets

~~nope. it could never happen.~~ ^^it happened.^^ nope. it could never happen. it happened.

HTML

markdown is merely a thin façade between you and the pointy depths of HTML. all HTML tags are allowed, including those which steal the administrators' cookies.

that is a lie.

allowed HTML tags
  • <p>
  • <h1>, <h2>, <h3>, ...
  • <pre>
  • <del> and <ins>
  • <mark>
  • <img>
  • <marquee>
  • <sup> and <sub>
  • <table>, <thead>, <tbody>, <tr>, <th>, and <td>
  • <details> and <summary>
  • <hr>
  • <br>
  • <iframe> (be nice with this one)

custom tags

our innovative technological apiomatrix extends HTML with essential formatting features.

you have you get
<red>I lust for blood</red> I lust for blood
this is <mark>important</mark>. this is <markred>very important</markred>. this is important. this is very important.
<sitelen>mi sitelen+pona a</sitelen> mi sitelen+pona a
<pulsate>GEORGE</pulsate> GEORGE

for every HTML color, there is a tag named after that color, such as <red>, or <lightgoldenrodyellow>. additionally, it is possible to highlight text with a certain background color, using the <mark{color}> family of tags.

the <sitelen> tag renders toki pona text written in latin into a font which translates it to sitelen pona using ligatures. however, the sitelen pona font is set as a fallback on the site in general, so if you are using a UCSUR-based input method, it will function without any special markup.


olive (edited ) src #5076/1

I think that rather than # ## ### being h1 h2 h3 they should be h234, h1 is the thread title and having two of those is odd. also can we allow html small (I like to use it for little things like this (discord calls it "-#")

ubq323 (bureaucrat) src #5090/0

patches welcome!

Paxtonpenguin src #5101/0

seems like the link with a caption is broken, it goes to https://a.gh0.pw/thread/example.com and not https://example.com

ubq323 (bureaucrat) src #5106/0

both the links work for me. what browser are you on, and can you show us the html source it's seeing?

ubq323 (bureaucrat) src #5107/0

oh, citrons edited it

citrons (bureaucrat) src #5108/0

this is because I fixed it.

citrons (bureaucrat) src #5109/0

yes.

citrons (bureaucrat) src #5110/0

I think that rather than # ## ### being h1 h2 h3 they should be h234, h1

I think it's fine (and matches e.g. wikipedia), and changing it would mess with existing posts.

citrons (bureaucrat) src #5111/0

small now exists.

small [...] (discord calls it "-#")

wretched.

ubq323 (bureaucrat) src #5113/0

you're wretched

heavoid src #5117/0

i'm so glad. i'm so, so glad.

please log in to reply to this thread