While SilverBullet is aimed at primarily text-based content, life can not fully be represented in text always. Therefore, SilverBullet supports documents. Documents, like Page ultimately are — once again — just files on disk. Using plugs, documents of specific file types can also be viewed and edited.
Uploading
To create a document, you have a few options:
- Use the ${widgets.commandButton(“Upload: File”)} command (especially useful on mobile devices)
- Drag & drop files or images onto a page
- Copy & paste files or images onto a page
All options will prompt you for a file name to use to store the document, and then include the document as an embedded image (if it was an image) or link to the file.
Managment
Using Cmd-o/Ctrl-o you can open the document navigator, which will display all documents in your Silverbullet space. You can either:
- Delete or rename documents for which no Document Editor is available (indicated by the grey hint)
- Open and view documents for which a Document Editor is available (indicated by the blue hint)
Linking
Documents can be linked to in two ways:
- Via the regular link syntax:
[link text](document.pdf). URLs here are relative to the page, so on a page namedMyFolder/Hello,[link text](document.pdf)would refer to a document stored inMyFolder/document.pdf. - Via the wiki link syntax:
[[document.pdf]]. These paths are absolute and relative to your space’s root, just like regular page links. That is: on a pageMyFolder/Helloa document link[[document.pdf]]would link to the filedocument.pdfin the space’s root folder.
Embedding
Media can also be embedded using the Linking syntax, but prefixed with an !:
Images, videos, audio and PDFs are currently supported.
![[image.png]]
These follow the same relative/absolute path rules as links described before.
Media resizing
In addition, media can be sized using the following syntax:
- Specifying only a width:
or![[image.png|300]] - Specifying only a height:
or![[image.png|x300]] - Specifying both width and height:
or![[image.png|300x300]]