I know the reverse is possible. You can insert source code blocks in org files. But how do I do the opposite?
I have figured out a way where I can insert a link to a line in a file in my source file comments. But as my org files grow and content is moved around that is not ideal. I need a nice way to link from source file comments to documentation written in org-mode. Something that links to a structure heading instead of absolute line number would be better.
If the exact opposite of the source code block in org-mode was not possible then some features of org-mode would be useful. I guess I could copy and paste tables from org-mode files. The most missed feature would be more robust links that are not so easily broken by growing and shrinking files.
I ended up adding these shortcuts. Experimenting with this feature I will see how I can improve it.
(global-set-key (kbd "s-l s") 'org-store-link)
(global-set-key (kbd "s-l i") 'org-insert-link)
(global-set-key (kbd "s-l o") 'org-open-at-point)