John Gruber 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 own search of support for file transculsion we landed on a syntax for what we call, Content Blocks.
Adding Content Blocks
Embedding images, comma separated tables, text files and code as blocks of content in your documents is easy on Mac.
Simply drag these files into your Editor or type their path using the syntax below.
Section.txt "Section"
Balance Sheet.csv 'Finances'
images/Structure.jpg (Data Flow)
💡 In iA Writer 6.0+, autocomplete will help find and add Content Blocks for you. You can trigger autocomplete by typing a / and the first few letters of the file you’d like to add. Then, select and hit return and, voila!
Rules
- Content block references must begin at the start of an empty line
- You may specify a caption in quotes or parentheses (this will be ignored when used where it does not have an immediate purpose, such as with .txt files)
- Only files in the Library may be referenced (dragging a file onto the Editor adds a copy in the Library)
Exporting Documents with Content Blocks
Among many export options, iA Writer for Mac allows you to export an archive of a project containing Content Blocks.
When you export a document that includes Content Blocks, the blocks are exported to a .zip archive maintaining the structure of your document.
Learn more about export options!
John Gruber
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 own search of support for
file transculsion we landed on a syntax for what we call, Content Blocks.
Adding Content Blocks
Embedding images, comma separated tables, text files and code as blocks of content in your documents is easy on iOS.
On iOS, Tap the
Add Content Block button in the Lightning menu to embed a file from your library in the current document.
Alternatively you can type the file path using the syntax below.
Section.txt "Section"
Balance Sheet.csv 'Finances'
images/Structure.jpg (Data Flow)
💡 In iA Writer 6.0+, autocomplete will help find and add Content Blocks for you. You can trigger autocomplete by typing a
/ and the first few letters of the file you’d like to add. Then, select from the list of suggestions and, voila!
Rules
- Content block references must begin at the start of an empty line
- You may specify a caption in quotes or parentheses (this will be ignored when used where it does not have an immediate purpose, such as with .txt files)
- Only files in the Library may be referenced
- Content Blocks are not currently processed in the From Other Apps
Exporting Documents with Content Blocks
Among many export options, iA Writer for iOS allows you to export an archive of a project containing Content Blocks.
When you export a document that includes Content Blocks, the blocks are exported to a
.zip archive maintaining the structure of your document.
Learn more about
export options!
John Gruber
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 own search of support for
file transculsion we landed on a syntax for what we call, Content Blocks.
Adding Content Blocks
Embedding images, comma separated tables, text files and code as blocks of content in your documents is easy on iPadOS.
On iPadOS, Tap the
Add Content Block button in the Lightning menu to embed a file from your library in the current document.
Alternatively you can type the file path using the syntax below.
Section.txt "Section"
Balance Sheet.csv 'Finances'
images/Structure.jpg (Data Flow)
💡 In iA Writer 6.0+, autocomplete will help find and add Content Blocks for you. You can trigger autocomplete by typing a
/ and the first few letters of the file you’d like to add. Then, select from the list of suggestions and, voila!
Rules
- Content block references must begin at the start of an empty line
- You may specify a caption in quotes or parentheses (This will be ignored when used where it does not have an immediate purpose, such as with .txt files)
- Only files in the Library may be referenced
- Content Blocks are not currently processed in the From Other Apps
Exporting Documents with Content Blocks
Among many export options, iA Writer for iPadOS allows you to export an archive of a project containing Content Blocks.
When you export a document that includes Content Blocks, the blocks are exported to a
.zip archive maintaining the structure of your document.
Learn more about
export options!
John Gruber
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 own search of support for
file transculsion we landed on a syntax for what we call, Content Blocks.
Adding Content Blocks
Embedding comma separated tables, text files and code as blocks of content in your documents is easy on Android.
Simply type the file path using the syntax below.
/Section.txt
/Balance Sheet.csv "Finances"
Rules
- Content block references must begin at the start of an empty line
- They must start with a slash, followed by file name with extension
- You may specify a caption in double quotes (This will be ignored when used where it does not have an immediate purpose, such as with .txt files)
- Only files in the Library may be referenced
- Referenced files must be located in the same folder as the file where they are referenced
John Gruber
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 own search of support for
file transclusion we landed on a syntax for what we call, Content Blocks.
Adding Content Blocks
Embedding images, tables and other text files is easy on Windows.
Simply drag these files into your Editor or type their path using the syntax below.
Syntax Example:
/Section.txt "Section"
/images/Structure.jpg 'Data Flow'
/Balance Sheet.csv
Rules
- Content block references must begin at the start of an empty line
- They must start with a slash, followed by file name with extension
- You may specify a caption in quotes or parentheses (This will be ignored when used where it does not have an immediate purpose, such as with .txt files)
- Only files in the Library may be referenced
- Referenced files must be located either in the same folder as the file where they are referenced, or in a subfolder
These embedded files are rendered in the Preview and will be included in documents exported to HTML, PDF, Markdown and Microsoft Word.
Library 
