Determine file type and comment name accordingly

[bmuenzenmeyer]

Markdown injection currently places a block like this:

File: foo/bar.js

console.log('Hello World')

We traditionally document files, instead, like this:

// foo/bar.js
console.log('Hello World')

We should find a library or write up some code that takes our common markdown languages and creates file name comments out of them. In some cases (like json), we may just need to retain the File: ___ message.

Examples:

<!-- index.html -->
<div>Hello World</div>

# deploy.sh
npm run release
git push --follow-tags origin main

# .vela.yml
steps:
  - name: test
    image: node
    commands:
      - npm i
      - npm test

File: package.json

{
  "name": "my-app",
  "scripts": {
    "start": "praxis-scripts start"
  },
  "dependencies": {
    "praxis-scripts": "10.1.0"
  }
}

Alternatively, we could document JSON as json5

// package.json
{
  "name": "my-app",
  "scripts": {
    "start": "praxis-scripts start"
  },
  "dependencies": {
    "praxis-scripts": "10.1.0"
  }
}

---

Languages we have ```[lang] blocks of in the monorepo currently:

• bash
• diff
• docker
• js
• json
• jsx
• markdown
• nginx
• sh
• ts
• txt
• yaml

Languages we don't have but should probably support because they might sneak in:

• yml (I usually write yaml this way)
• tsx
• json5?