Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Markdoc, .mdoc #6721

Open
jasikpark opened this issue Feb 26, 2024 · 3 comments
Open

Add Markdoc, .mdoc #6721

jasikpark opened this issue Feb 26, 2024 · 3 comments
Labels
Add Language Good First Issue This is a great opportunity to start contributing to Linguist

Comments

@jasikpark
Copy link

jasikpark commented Feb 26, 2024

Language name

Markdoc - https://markdoc.dev

URL of example repository

https://github.com/withastro/astro/blob/main/examples/with-markdoc/src/content/docs/intro.mdoc
https://github.com/markdoc/docs/blob/main/pages/index.md

URL of syntax highlighting grammar

https://github.com/markdoc/language-server/tree/main/syntaxes

Most popular extensions

.mdoc, .md

Detected language

Roff

@jasikpark jasikpark added Add Language Good First Issue This is a great opportunity to start contributing to Linguist labels Feb 26, 2024
@Alhadis
Copy link
Collaborator

Alhadis commented Feb 27, 2024

Most popular extensions: .mdoc, .md

Ugh, this project picked two file extensions already in-use by existing markup languages (Roff and Markdown). Assuming that Markdoc achieves sufficient usage on GitHub, adding support for it is going to be a pain-in-the-arse… 😞

@spenserblack
Copy link
Contributor

If I understand correctly, Markdoc boils down to Markdown plus an extended syntax like {% this %}? If so I imagine a lot of repositories that use Markdown with other template tools that use this Jinja-like syntax can get misidentified as Markdoc very easily.

I noticed that HTML+Django (alias of Jinja) does not have the .html extension, even though it's commonly used (see nearly every Django project). I assume this is intentional since the syntax would be too similar to tell them apart. Perhaps Markdoc should be treated similarly, and not have the .md extension registered for it?

@jasikpark
Copy link
Author

This is why every language should specify itself at the top of the doc like XHTML xD

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Add Language Good First Issue This is a great opportunity to start contributing to Linguist
Projects
None yet
Development

No branches or pull requests

3 participants