Markdown (but make it delightful)

Want to peek behind the curtain? See the source and pretend you're a wizard.

Quick rules: Markdown is like magic ink — sometimes it wraps, sometimes it doesn't, and sometimes it eats your trailing spaces for lunch. Here's a tiny ritual to prove it:

A wild poem appears
It smells faintly of commit messages

Now the same poem — but with dramatic pauses (and two newlines):

A wild poem appears

It smells faintly of commit messages

Also: please, for the love of readable diffs, stop feeding underscores to your markdown like they're an all-you-can-eat buffet: do_this_and_do_that_and_another_thing becomes a sad_unlinked_word nightmare. Use backticks or escape them and everyone wins.

A bit of the GitHub spice

GitHub: the place where your SHA gets more followers than you. Auto-linking is the internet's matchmaking service — issues, commits, and mentions all find each other and live happily ever after in a tidy timeline.

SHA: 29f8921
User@SHA ref: RajdeepKushwaha5@29f8921
User/Project@SHA: RajdeepKushwaha5/Lumen-by-RJDP@29f8921
#Num: #1
User/#Num: RajdeepKushwaha5#1
User/Project#Num: RajdeepKushwaha5/Lumen-by-RJDP#1

These are dangerous goodies though, and we need to make sure email addresses don't get mangled:

My email addy is rajdeepsingh10789@gmail.com.

Math is hard, let's go shopping

Math is just a suggestion until you ship. But yes, 5 > 3, arrows go brr, and sometimes your code needs the kind of angle brackets that trigger ancient compiler rituals.

Pythagoras: "a^2 + b^2 = c^2". Internet: "That escalated quickly."

We all like making lists

Lists are content's flexbox. Here's a curated stash of developer snacks:

Cold pizza (breakfast of champions)
Rubber duckies for debugging whispers
Sticky notes with TODOs from 2016

Let's get crazy:

This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.

Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

What about some code in a list? That's insane, right?

Rust flex (type-safe and intimidating):

let v = vec!["a", "b"];
let upper: Vec = v.iter().map(|x| x.to_uppercase()).collect();
println!("{:?}", upper);

JavaScript energy (short and snackable):

['a', 'b'].map(x => x.toUpperCase()); // ["A", "B"]

Some people seem to like definition lists

Lower cost: The new version of this product costs significantly less than the previous one!
Easier to use: We've changed the product so that it's much easier to use!

I am a robot

Beep boop: when your CI bot writes more PR comments than your teammates. Here's the classic robot flex — printed a thousand times because quantity > quality.

for i in 1..1000
  puts "robot"
end

Yes, it's code. Yes, it runs. No, it won't make your morning coffee (yet).

How about we throw some angle braces and ampersands in there?

<div class="footer">
    &copy; 2004 Foo Corporation
</div>

Set in stone

Preformatted blocks are useful for ASCII art:

Preformatted blocks are useful for ASCII art — but let's upgrade it to a crisp vector sketch:

      _.-"""-._
    .'  _ _    '.
   /   (o) (o)   \
  |                 |
  |  \           /  |
   \  '._.-._.-'  /
    '.           .'
      '-._____.-'
         /  |  \
        /   |   \
       /    |    \
      '-----'-----'
            ( )
             -
            / \
            `-'

Playing the blame game

When things go wrong, the internet suggests a scapegoat. In open source, we blame commits, not people. Here's a vintage quote to throw at your successor.

"It wasn't a bug, it was an undocumented feature." — Every legendary maintainer

Table for two

ID	Name	Rank
1	Rajdeep Kushwaha	Owner

Crazy linking action

I get 10 times more traffic from Google than from
Yahoo or MSN.