5 ms·

Hyper-Markdown – Markdown for knowledge graphs

33 points by divingstar 1mo ago

0x696C6961 1mo ago
This just looks like obsidian's markdown flavour.
haburka 1mo 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 1mo 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 1mo ago
  interestingly, the question is probably more if a AI can usefully use this than any dev.
type0 1mo ago
I was hoping for hypertext inspired markdown, instead it's a regular one with hyperinflated promises
divingstar 1mo 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 1mo ago
  [dead]
MiroslavPokorny 1mo ago
I see python and typescript(not published yet), are there any plans for other implementations ?
zwaps 1mo ago
Thanks Claude for writing that

33 points by divingstar 1mo ago

This just looks like obsidian's markdown flavour.

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 1mo 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 1mo ago
interestingly, the question is probably more if a AI can usefully use this than any dev.

type0 1mo ago

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

divingstar 1mo 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 1mo ago
[dead]

MiroslavPokorny 1mo ago

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

zwaps 1mo ago

Thanks Claude for writing that