A Visual Studio Code extension for adding embedded markdown notes to code files.
Add markdown notes to your code using unobtrusive annotated comments. You can use all the standard markdown formatting, including images and links.
Comments are stored as markdown files in a directory or directories of your choice. You can commit these to your source control or not as you see fit.
Move the cursor to some point in a file where you wish to add a notation line. Select 'Add Margin Note' from the command palette or from the context menu. This will add a commented line that contains a notation reference and then open an editor pane in which you can enter markdown for the note. When you are done save the document and the editor will close automatically. Hover over the decorated note comment to see the rendered markdown in a hover pane.
Currently this is a manual process. To remove the notation from a file just delete the comment line containing the notation reference. Then remove the corresponding file (the one with the file name the same as the id in the notation comment) from the notes directory.
This extension contributes the following settings:
When performing archeology on a codebase I often come across sections of code that need clarification. I used to jot down notes in a notebook or text file when I came to a section of code that I didn't quite understand, but this meant my notes were separated from the code. Sure I can add clarifying comments to the code, but sometimes I don't want to clutter things up with long comments that might not be needed for everyone.
This extension provides the best of both worlds - notes are embedded in the code the way comments are, but with minimal impact. And you can utitlize all the power of markdown to add formatting, links, and charts to your notes.