4 ms·

Hyper-Markdown – Markdown for knowledge graphs

33 points by divingstar 2mo ago

divingstar 2mo ago
Hyper-Markdown (`.hmd`) is ordinary Markdown plus rich visuals plus wiki links into a knowledge graph. Every `.md` file is already valid `.hmd`. * Early language specification draft, still very open to change * Looking for contributors and feedback — both are welcome! * There is already a lightweight proposal process for discussing changes * Docs, specification and implementation are available at https://hyper-markdown.org/ https://hyper-markdown.org/ If this direction sounds useful, I'd love people to try it, challenge the design, or get involved.
- divingstar 2mo ago
  [dead]
MiroslavPokorny 2mo ago
I see python and typescript(not published yet), are there any plans for other implementations ?
zwaps 2mo ago
Thanks Claude for writing that
0x696C6961 2mo ago
This just looks like obsidian's markdown flavour.
haburka 2mo ago
If you can’t take the time to write an actual introduction for your library and instead delegate it to AI, why would anyone take the time to try your library out and see if it’s useful? I understand using AI to document but for the front page of your programming project it should be hand written. Maybe with some AI assistance for grammar.
Planktonne 2mo ago
I'm all in favour of Markdown with more capabilities, but this isn't a useful project. Generated docs like this are worse than gibberish--they take far longer to parse, and there's no way of knowing if any one sentence is actually meaningful or correct. There are definitely some places where the docs aren't coherent, but those are (ironically) the best bits: you can verify quality immediately. With meaningful documentation, I could be tempted to use this. As it is, this reads worse than a Markov chain (which is at least obviously nonsense) and makes me extremely skeptical of the project's quality or use.
- cyanydeez 2mo ago
  interestingly, the question is probably more if a AI can usefully use this than any dev.
type0 2mo ago
I was hoping for hypertext inspired markdown, instead it's a regular one with hyperinflated promises

33 points by divingstar 2mo ago

Hyper-Markdown (`.hmd`) is ordinary Markdown plus rich visuals plus wiki links into a knowledge graph. Every `.md` file is already valid `.hmd`. * Early language specification draft, still very open to change * Looking for contributors and feedback — both are welcome! * There is already a lightweight proposal process for discussing changes * Docs, specification and implementation are available at https://hyper-markdown.org/ https://hyper-markdown.org/ If this direction sounds useful, I'd love people to try it, challenge the design, or get involved.

divingstar 2mo ago
[dead]

MiroslavPokorny 2mo ago

I see python and typescript(not published yet), are there any plans for other implementations ?

zwaps 2mo ago

Thanks Claude for writing that

0x696C6961 2mo ago

This just looks like obsidian's markdown flavour.

haburka 2mo ago

If you can’t take the time to write an actual introduction for your library and instead delegate it to AI, why would anyone take the time to try your library out and see if it’s useful? I understand using AI to document but for the front page of your programming project it should be hand written. Maybe with some AI assistance for grammar.

Planktonne 2mo ago

I'm all in favour of Markdown with more capabilities, but this isn't a useful project. Generated docs like this are worse than gibberish--they take far longer to parse, and there's no way of knowing if any one sentence is actually meaningful or correct. There are definitely some places where the docs aren't coherent, but those are (ironically) the best bits: you can verify quality immediately. With meaningful documentation, I could be tempted to use this. As it is, this reads worse than a Markov chain (which is at least obviously nonsense) and makes me extremely skeptical of the project's quality or use.

cyanydeez 2mo ago
interestingly, the question is probably more if a AI can usefully use this than any dev.

type0 2mo ago

I was hoping for hypertext inspired markdown, instead it's a regular one with hyperinflated promises