I exported a notebook to markdown (which is great), but I found that the files don't have links to other files like they were in Siyuan.
So, is there anyway to make markdown exports have links to other files?
Is it possible for markdown export to link to other files?
This post was last updated for 461 days ago, and the information may already be changed
1 Reference
Related articles
-
Siysuy •
The
anchor hashfeature currently creates a span object<span id="20231110120736-ze6m41f"></span>. Some kind of program should be able to understand and find this block inside the note as reference. Can anyone help me understand how this can be useful after export, where do I use this, which program understands this syntax?The export mode
Anchor hashfor notebook Markdown exporting has some limitations.In the case i want to publish a particular note (with links to other notes) my approach is:
- From main notebook export the notebook you want to publish to .sy.zip file
- Create new (temporary) notebook
- import .sy.zip file to new temp notebook
- Export temp notebook export it to any selectable format (only markdown is currently selectable)
Other limitation of
Anchor hasexport and the only way I got it to work (performed testing by exporting to Obsidian):- currently only works for notebook and does not allow nested notes. In the process of exporting all notes must be unnested inside notebook for .md export to function.
- Currently does not support block reference. Can only link to main note. Tested by importing to obsidian (not a siyuan issue, but a markdown syntax limitation i presume)
Depending on the responses here I might add a feature request soon that involves the concept of user selectable export syntax. In which before execution of export using
anchor hasha user can type in the conversion syntax to apply. User is presented with input fields much like thesettings > Export > Anchor text wrapping symbolfields.Conversion syntax for siyuan > obsidian would be: [[test3.md/Note 2#^d8bf62|Note 2]] and conversion input fields could somehow be [[ .. / .. #^ .. | .. ]]
1 Reply - MiscReply
-
sagar •VIP Warrior
@adham Wow 😍 You are a master programmer indeed! I was still trying to figure out how to use Python to open all .md files in a directory, by copy/pasting code from Stackoverflow 😄 This solution is exactly what I meant.
I do believe it can be extended to include references to any arbitrary block, not just a document block. You did say that you don't want to mutate the linked documents, but I am just laying out the approach in case any other master programmers want to try it 😄. You wrote,
I don't know how to find out if the link is of a block or a document,
I see a few different possible checks for this
- Look at the 'type' field in the response of the SQL query. If it is a document block, the type value will be 'd'. Other type values are given in the documentation at /Please Start Here/Advanced search/Type filtering
- I believe that if the block is of type document, then the 'root_id' will be the same as 'id'. See the documentation of the SQL table fields at /Please Start Here/Advanced search/Database table
So one or both of the above checks can be used to determine if the block is of type 'document' or something else.
If the block is of type something else, then the way to link to it would be
- Open the target document that contains the block (i.e. the hpath)
- Search for the occurrence of the content in the 'markdown' field of the SQL query response. This will place the "cursor" inside the document to the start of the paragraph (or whatever other content) the block points to
- At this cursor position, insert an HTML anchor text like:
<a name="block-id"></a> - Then, update the
siyuan://blocks/block-idpart of the link tohpath_value.md#block-id
This approach enables having links in the markdown files to any other markdown files or parts inside markdown files.
@adham Thank you once again for your example code 🙏
-
Siysuy •
I appreciate your resonse, but it is not only for complete batch export for users to turn away from siyuan, but rather for collaborative reasons and to publish notes. Users of Siyuan can collaborate and share specific notes.
I just want a guide on how to use
anchor hash. How would I proceed after I used the feature after export, so postanchor hash. I do not quite understand what to do with the new file after export.1 Reply -
Siysuy •
I think the issue remains with
anchor hashfor the reason that it is limited to notebook currently, meaning I cannot select rendering from Markdown to HTML from thenotebook_ex > export > (selectable=Markdown/siyuan.sy.zip).How would i export my notes to HTML with
anchor hash? I think I would be limited to usingpandoc input.md -o output.html, I tried it with pandoc, which succesfully creates html with link to other note, but it just opens the other note without navigation to the<span>block, so no hash jump in browser (brave/firefox) to block.1 Reply - Visit all replies
Welcome to here!
Here we can learn from each other how to use SiYuan, give feedback and suggestions, and build SiYuan together.
Signup About