Skip to content

Встраивание вложений в заметки

Вложенные файлы

Вы можете вложить в заметку файлы, такие как изображения или аудиофайлы. Используйте следующий синтаксис ![[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 синтаксиса вставки изображений и исходили из следующих идей:

  1. [Image](link.png) ссылается на изображение, а ![Image](link.png) встраивает его.

  2. Синтаксис внутренней ссылки основан на предположении, что [[My page]] это сокращение (или «синтаксический сахар», если хотите) для [My page](My page).

Объединив эти две вещи, мы создаем третий паттерн ![[My page]], являющийся эквивалентом ![My page](My page) и соответствующий синтаксису встраивания изображений. При этом название в ссылке должно совпадать с именем заметки.

Встречаются и другие варианты реализации этого механизма. Например, в Roam Research для встраивания используется {{embed: ((NODE_ID))}}. Мы тоже рассматривали возможность использования подобного синтаксиса ((Page name)), но, как нам кажется, ![[Page name]] больше подходит для этого. Он понятен и оставляет больше вариантов для использования других символов по назначению.

Изменение размера изображений

Вы можете изменять размер изображений используя следующий синтаксис:

В формате Markdown ![AltText|100x100](https://url/to/image.png), где 100x100 соответствует ШИРИНАxВЫСОТА.

В формате обычной вставки ![[image.png|100x100]].

Чтобы сохранить соотношение сторон изображения при масштабировании, опустите параметр высоты ![[image.png|100]].

Back to top