Встраивание вложений в заметки
Вложенные файлы¶
Вы можете вложить в заметку файлы, такие как изображения или аудиофайлы. Используйте следующий синтаксис ![[filename.png]]
:
![[Engelbart.jpg]]
![[Excerpt from Mother of All Demos (1968).ogg]]
Вы можете вложить PDF-файл в заметку используя тот же синтаксис. В дополнении к этому, вы можете указать определенную страницу внутри него: ![[My File.pdf#page=number]]
.
Вложенные заметки¶
Тем же способом можно вложить и другую заметку:
![[Поддерживаемые форматы файлов]]
Использование iframe¶
«iframe» — это способ вложения одной веб-страницы в другую. Он может использоваться, так как Markdown поддерживает использование HTML, который является простейшим языком для построения веб-страниц, которые мы видим каждый день.
Например, такая запись:
<iframe src="https://www.youtube.com/embed/NnTvZWp5Q7o"></iframe>
Встраивает видео с Youtube:
Основной синтаксис выглядит так:
<iframe src="ВСТАВЬТЕ ВАШУ ССЫЛКУ ЗДЕСЬ"></iframe>
Некоторые веб-сайты имеют особенности, не позволяющие их встраивать. Например, вы не можете встроить видео с YouTube, используя обычную ссылку, но вы можете встроить его с использованием ссылки вида https://www.youtube.com/embed/VIDEO_ID
.
Если вы хотите встроить веб-сайт, попробуйте поискать для него встраивание в формате «{название_сайта} embed iframe».
Например, вы можете вставлять твиты из Twitter так, как это предлагается в результатах поиска:
<iframe
border=0
frameborder=0
height=250
width=550
src="https://twitframe.com/show?url=https%3A%2F%2Ftwitter.com%2Fjack%2Fstatus%2F20">
</iframe>
Примечания разработчика¶
Мы отталкивались от уже имеющегося в Markdown синтаксиса вставки изображений и исходили из следующих идей:
-
[Image](link.png)
ссылается на изображение, а
встраивает его. -
Синтаксис внутренней ссылки основан на предположении, что
[[My page]]
это сокращение (или «синтаксический сахар», если хотите) для[My page](My page)
.
Объединив эти две вещи, мы создаем третий паттерн ![[My page]]
, являющийся эквивалентом 
и соответствующий синтаксису встраивания изображений. При этом название в ссылке должно совпадать с именем заметки.
Встречаются и другие варианты реализации этого механизма. Например, в Roam Research для встраивания используется {{embed: ((NODE_ID))}}
. Мы тоже рассматривали возможность использования подобного синтаксиса ((Page name))
, но, как нам кажется, ![[Page name]]
больше подходит для этого. Он понятен и оставляет больше вариантов для использования других символов по назначению.
Изменение размера изображений¶
Вы можете изменять размер изображений используя следующий синтаксис:
В формате Markdown 
, где 100x100
соответствует ШИРИНАxВЫСОТА
.
В формате обычной вставки ![[image.png|100x100]]
.
Чтобы сохранить соотношение сторон изображения при масштабировании, опустите параметр высоты ![[image.png|100]]
.