Cross-references:
The one of the major feature of UmlSync is cross-references support by each element of diagram.
You could create one or more references for each element and all these references will be available for embedded diagrams too.
For example:
>You could insert the common platform components overview diagram on the first README.md document.
>User could click on the concreate UML-component of embedded diagram and switch to the component description page by reference like this "./components/concreate_component.md".
>The "components/concreate_component.md" document could contain diagram which describes sub-components and user could select subcomponent etc.
Thus you could make a smooth transition from a High Level Design of your project to a Low Level Design of concreate module/component/feature.