Click or drag to resize
Block Image

The block image allows embedding a lone image in a document.

Syntax

A link preceded by a ! (bang) character occurring by itself in a paragraph.

Note Note
The link text of a block image will be interpreted as the image's caption. If no link text is specified, a captionless image will be generated.
Tip Tip
Inserting a nonbreaking space after a lone image will cause it to be rendered as an inline image.
Example
AMDL
This is a block image:

![Sandcastle](Castle.png "Pirate Sandcastle")
Example Output

This is a block image:

Sandcastle

Attributes

Block image attributes may be specified using the following syntax:

{#identifier .class1 .class2 name1="value1" name2="value2" ...}

The following attributes are defined:

identifier

  • Ignored.

class

  • any of the following:

    • inline - the image will be rendered as an inline image.

    • near - equivalent to specifying placement="near".

    • center - equivalent to specifying placement="center".

    • far - equivalent to specifying placement="far".

    • before - equivalent to specifying captionPlacement="before".

    • after - equivalent to specifying captionPlacement="after".

altText

  • a string value that will be used as the alternate text. If no value is specified, the link value will be used.

caption

  • a string value that will be used as the caption in a block image. If no value is specified, the link text will be used.

placement

  • one of the following:

    • near

    • center

    • far

    If no value is specified, near will be used.

captionPlacement

  • one of the following:

    • before

    • after

    If no value is specified, before will be used.

captionLead

  • a string value that will be used as the caption lead-in.

Differences from PM
  1. PM does not define image attributes.

amdl2maml Support

Partial, pending parser modification.

Limitations:

  1. Alt text is unsupported.

  2. Attributes are unsupported.

Current Workarounds:

  1. Manually edit the image's properties in the SHFB project.

  2. N/A

See Also