The Mirror Editor enables composing entries with media blocks, such as images and videos, along with crypto economic blocks, like crowdfunds and auctions. It uses plain text and Markdown with a few formatting conventions.


Composition takes place in Edit mode. To preview your entry as it will appear on your publication enter Preview mode. You can toggle between them with the related buttons in the toolbar.

Importing entries

To import entries from elsewhere, such as Medium or Substack, open the secondary ••• menu in the navigation, then click Import entry. Next, enter the URL to your entry. The url will be parsed into markdown, and set as the content of your entry. Please only import content you have created and own.

Creating blocks

To easily create a media or economic block, first click inside your entry to place the curser where you’d like the block to appear. Next, click the Blocks area of the Toolbar, or focus with the keyboard shortcut ⌘+/. The blocks menu will appear, showing you all available blocks. Selecting a block prompts you for secondary information. Once you’re satisfied, confirm the information to insert the block into your entry.


Media embeds and economic blocks on Mirror are recognized with a simple formatting convention: an individual link on it’s own line of text. To manually create a block, insert a new line of text, add a link, then add a line break. Ensure that the new line only contains a single link. Here is an example which creates a Youtube video embed.

Powers of Ten illustrates the universe as an arena of both continuity and change, of everyday picnics and cosmic mystery.

[Powers of Ten](https://www.youtube.com/watch?v=0fKBhvDjuy0)

We hear about scale every day, whether it be supertankers, stars burning thousands of lightyears away, the study of microscopic viruses, or global warming. Understanding scale, or as the Eameses said, “the effect of adding another zero,” has the power to make us better scholars and better citizens.

We’ve decided to parse basic links—as opposed to introducing Mirror specific syntax—to ensure portability. If the markdown is rendered with Mirror you will see a Mirror Block. If anywhere else, you’ll see a simple plain text link. There are a number of integrations, and we’re adding more every week.


Embed an NFT by creating a link. Prefix the URL with the ethereum:// protocol, followed by the address/id. Currently supports a images, audio, video, and text embeds. Mirror currently supports EthBlock.art, Foundation, Rarible, SuperRare and Zora.

[NFT Example](ethereum://0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0/16297)


Create a crowdfund and deploy it. After it has been deployed, a snippet of code will appear in the Embed crowdfund section. Copy and paste this into an entry. It should look like the example below, but with your dedicated crowdfund address.

[BURN ALPHA NOVEL](crowdfund://0x95d0A89943E0e3e05d290Fc07462c148EB6a11Ff?network=homestead)


Create an auction and deploy it. After it has been deployed a snippet of code will appear in the Embed auction section. Copy and paste this into an entry. It should look like the example below, but with your dedicated auction address and tokenID.

[Token #1522](auction://0xabEFBc9fD2F806065b4f3C237d4b59D9A97Bcac7?network=mainnet&tokenId=1522)


Embedding images is possible by dragging and dropping into the editor, selecting Image in the blocks menu, or manually creating a markdown image tag. Reserving the space of the image prior to loading is possible by defining the width and height query parameters, which are automatically set when uploading an image to Mirror.

![Image caption](https://images.mirror-media.xyz/publication-images/589ec9e9-59a2-4505-ba83-35210d01c223.jpeg?height=1180&width=1588)
Image caption
Image caption

Mirror displays a progressively enhanced preview of all links based on the universal standard of OpenGraph tags.



Embed an individual Tweet or an entire Tweet thread by inserting a link to any Twitter URL.

[Mirror’s first tweet](https://twitter.com/viamirror/status/1325856116748726273)


[Powers of Ten](https://www.youtube.com/watch?v=0fKBhvDjuy0)

Video embeds

Embed an .mp4 video by inserting a link to an externally hosted video file. It is also possible to set autoplay, muted, loop and controls by setting the related query parameters. Ensure you manually define the width and height parameters to reserve the vertical space for your video.

[Powers of Ten](https://jkm-library.s3.amazonaws.com/blocks/powers-of-10.mp4?height=480&width=640&autoplay=true&loop=true&muted=true)


It’s possible to embed any page by creating an iFrame block. This is useful when embedding interactive WebGL content, for example. Simply set display=iframe as a query parameter.

[ThreeJS Demo](https://threejs.org/examples/webgl_water_flowmap.html?display=iframe)

Layout sizes

If you’re looking to create a more editorial layout for your entry, consider setting custom layout sizes for certain media blocks. Supported block types include Image, Video, Youtube and iFrame.

The block size is set with a query parameter, and it is possible to choose from both medium and large. For example, below is a large image which extends to the edges of the page.


Future enhancements

Mirror is a new project, and our editor is intentionally focused as we move fast to create new economic tools to fund great writing. In time we plan to introduce a new editor which enables editing in place, removing the need to toggle between edit and preview modes. Until then, we appreciate your patience, and welcome any feedback.

Previous guide
Next guide