Update docs content to use Prismjs syntax highlighting and ref: auto-link options

[yathomasi]

With #233, the following features were added

1. prismjs syntax highllighting #157
2. ref: auto-link options #187

Now, we need to update content similar to dvc.org to use them (jump to #239 (comment)).

cc: @iterative/docs

[jorgeorpinel]

the following features were added

Can you be specific about which highlighters exist or how to enable them, as well as auto-linking? We'll want to document this at some point anyway (maybe in the docs engine repo README + contrib guides).

[yathomasi]

Existing highlighters:

1. dvc
   • parses on line basis (accepts $ as first character which is skipped while copying)
   • highlights
     • dvc commands
     • git commands
     • bash commands
2. dvctable
   • parses on row/line basis
   • highlights
     • white|neutral
     • yellow|metric
     • blue|param
     • violet|dep
3. usage
   • highlights
     • dvc commands
     • cml commands (addition)
     • usage commands usage|positional arguments|optional arguments
     • args highlights the arguments in [--arg] pattern (inside square bracket with double dashes) (auto-linking)
4. cml (addition)
   • parses on line basis (accepts $ as first character which is skipped while copying)
   • highlights
     • cml commands
     • git commands
     • bash commands

Usage:

```dvc | dvctable| usage| cml
respective content
```

[casperdcl]

Er... Can

• cml be an alias of dvc?
• both of the above highlight all of our tools (dvc/cml/mlem/...)?

[jorgeorpinel]

Can cml be an alias of dvc? ... highlight all of our tools

See discussion in iterative/mlem.ai#59 (comment) 🙂

[casperdcl]

Yes basically would like this rather than this

[jorgeorpinel]

Is this still outstanding @yathomasi ? Thanks

[rogermparent]

Seems like the cli highlighter that's already in closes this issue.

[jorgeorpinel]

Can cml be an alias of dvc?

Note that the highlighter name is now cli @casperdcl . I think both dvc and cml will be aliases of that but I recommend we use cli going fwd.

Do you want to keep this issue open to update existing content and use the highlighters more?

[rogermparent]

Unless something has changed, we only have dvc as an alias but we're encouraging moving to full cli, we've already mass replaced instances of ```dvc in a few repos.