On macOS, effortlessly insert images, text files, code, or CSV tables into your documents with Content Blocks.
Besides the integration of elements into your file, this feature also offers an excellent document management solution alongside the Table of Content or Library options like Favourite, Smart Folders, or Hashtags.
Among all the use cases, Content Blocks are particularly popular for writers who need to compile various chapters of their book into a unified document.
John Gruber, one the inventors of the Markdown markup language, remarked that image syntax was his biggest mistake with Markdown, and mentioned an alternative:
My best idea for good Markdown img syntax would be to just paste in a URL ending in .jpg/.png/.gif etc.
In our search of support for file transclusion, we landed on a syntax for what we call, Content Blocks.
The Content Blocks feature was added to Writer a few years ago, if you want to know more about our journey with this, feel free to check our blog post from that time: iA Writer 4.
You have two ways to embed files in your document as Content Blocks. In both cases, the same principles should be followed:
Simply drag and drop the file you would like to embed into your document opened in the Editor.
This can be done from iA Writer’s Library directly but also from Finder, or even your desktop (note that dragging a file onto the Editor adds a copy in the Library).
You can manually type the path of the file to embed in your target document. Be sure to respect the proper syntax, as below:
Section.txt "Section"
Balance Sheet.csv 'Finances'
images/Structure.jpg (Data Flow)
💡 Autocomplete will help find and add Content Blocks for you. To trigger autocomplete:
/ 
These embedded files are rendered in the Preview and will be included in documents exported to HTML, PDF, Markdown and Microsoft Word.
On iOS, effortlessly insert images, text files, code, or CSV tables into your documents with Content Blocks.
Besides the integration of elements into your file this feature also offers an excellent document management solution alongside the Table of Content or Library options like Favourite, Smart Folders, or Hashtags.
Among all the use cases, Content Blocks are particularly popular for writers who need to compile various chapters of their book into a unified document.
John Gruber, one the inventors of the Markdown markup language, remarked that image syntax was his biggest mistake with Markdown, and mentioned an alternative:
My best idea for good Markdown img syntax would be to just paste in a URL ending in .jpg/.png/.gif etc.
In our search of support for file transclusion, we landed on a syntax for what we call, Content Blocks.
The Content Blocks feature was added to Writer a few years ago, if you want to know more about our journey with this, feel free to check our blog post from that time: iA Writer 4.
You have two ways to embed files in your document as Content Blocks. In both cases, the same principles should be followed:
Tap the Add Content Block button in the Lightning menu to embed a file from your library in the current document.
A small pop window will appear with a selection of files, click on the targeted one.
You can manually type the path of the file to embed in your target document. Be sure to respect the proper syntax, as below:
Section.txt "Section"
Balance Sheet.csv 'Finances'
images/Structure.jpg (Data Flow)
💡 Autocomplete will help find and add Content Blocks for you. To trigger autocomplete:
/ 
These embedded files are rendered in the Preview and will be included in documents exported to HTML, PDF, Markdown and Microsoft Word.
On iPadOS, effortlessly insert images, text files, code, or CSV tables into your documents with Content Blocks.
Besides the integration of elements into your file this feature also offers an excellent document management solution alongside the Table of Content or Library options like Favourite, Smart Folders, or Hashtags.
Among all the use cases, Content Blocks are particularly popular for writers who need to compile various chapters of their book into a unified document.
John Gruber, one the inventors of the Markdown markup language, remarked that image syntax was his biggest mistake with Markdown, and mentioned an alternative:
My best idea for good Markdown img syntax would be to just paste in a URL ending in .jpg/.png/.gif etc.
In our search of support for file transclusion, we landed on a syntax for what we call, Content Blocks.
The Content Blocks feature was added to Writer a few years ago, if you want to know more about our journey with this, feel free to check our blog post from that time: iA Writer 4.
You have two ways to embed files in your document as Content Blocks. In both cases, the same principles should be followed:
Tap the Add Content Block button in the Lightning menu to embed a file from your library in the current document.
A small pop window will appear with a selection of files, click on the targeted one.
You can manually type the path of the file to embed in your target document. Be sure to respect the proper syntax, as below:
Section.txt "Section"
Balance Sheet.csv 'Finances'
images/Structure.jpg (Data Flow)
💡 Autocomplete will help find and add Content Blocks for you. To trigger autocomplete:
/ 
These embedded files are rendered in the Preview and will be included in documents exported to HTML, PDF, Markdown and Microsoft Word.
On Android, effortlessly insert text files, code, or CSV tables into your documents with Content Blocks.
Besides the integration of elements into your file, this feature also offers an excellent document management solution alongside the Table of Content .
Among all the use cases, Content Blocks are particularly popular for writers who need to compile various chapters of their book into a unified document.
John Gruber, one the inventors of the Markdown markup language, remarked that image syntax was his biggest mistake with Markdown, and mentioned an alternative:
My best idea for good Markdown img syntax would be to just paste in a URL ending in .jpg/.png/.gif etc.
In our search of support for file transclusion, we landed on a syntax for what we call, Content Blocks.
The Content Blocks feature was added to Writer a few years ago, if you want to know more about our journey with this, feel free to check our blog post from that time: iA Writer 4.
In your document, simply enter a slash mark / then type the file path following the syntax below:
/Section.txt
/Balance Sheet.csv "Finances"
Note that some principles should be respected:
These embedded files are rendered in the Preview and will be included in documents exported.
On Windows, effortlessly insert images, text files, code, or CSV tables into your documents with Content Blocks.
Besides the integration of elements into your file this feature also offers an excellent document management solution alongside the Table of Content .
Among all the use cases, Content Blocks are particularly popular for writers who need to compile various chapters of their book into a unified document.
John Gruber, one the inventors of the Markdown markup language, remarked that image syntax was his biggest mistake with Markdown, and mentioned an alternative:
My best idea for good Markdown img syntax would be to just paste in a URL ending in .jpg/.png/.gif etc.
In our search of support for file transclusion, we landed on a syntax for what we call, Content Blocks.
The Content Blocks feature was added to Writer a few years ago, if you want to know more about our journey with this, feel free to check our blog post from that time: iA Writer 4.
You have two ways to embed files in your document as Content Blocks. In both cases, the same principles should be followed:
Simply drag and drop from your Library the file you would like to embed into your document, in the Editor.
You can manually type the path of the file to embed in your target document. Be sure to respect the proper syntax, as below:
/Section.txt "Section"
/images/Structure.jpg 'Data Flow'
/Balance Sheet.csv
These embedded files are rendered in the Preview and will be included in documents exported to HTML, PDF, Markdown and Microsoft Word.
Library 
Folders, favourites, hashtags and more, discover all the ways to organize your documents in Writer.
Create, search and navigate through your documents in the Library.
Connect, browse, and rediscover your writing.
Having access to your documents on multiple devices makes life easier.
Include images, comma separated tables, text files and code as blocks of content in your documents.
Writer for Windows comes with two powerful features for working with long or complex documents.