diff --git a/types/lib/elements/custom-style.d.ts b/types/lib/elements/custom-style.d.ts
index 0ceeae111c..a0c19a23d1 100644
--- a/types/lib/elements/custom-style.d.ts
+++ b/types/lib/elements/custom-style.d.ts
@@ -34,12 +34,12 @@ declare namespace Polymer {
    *
    * For example:
    *
-   * ```
+   * ```html
    * <!-- import apply shim--only required if using mixins -->
-   * <link rel="import href="bower_components/shadycss/apply-shim.html">
+   * <link rel="import" href="bower_components/shadycss/apply-shim.html">
    * <!-- import custom-style element -->
    * <link rel="import" href="bower_components/polymer/lib/elements/custom-style.html">
-   * ...
+   *
    * <custom-style>
    *   <style>
    *     html {
diff --git a/types/lib/elements/dom-repeat.d.ts b/types/lib/elements/dom-repeat.d.ts
index 1d085362da..db3c543b73 100644
--- a/types/lib/elements/dom-repeat.d.ts
+++ b/types/lib/elements/dom-repeat.d.ts
@@ -41,28 +41,30 @@ declare namespace Polymer {
    *
    *   </template>
    *
-   *   <script>
-   *     class EmployeeList extends Polymer.Element {
-   *       static get is() { return 'employee-list'; }
-   *       static get properties() {
-   *         return {
-   *           employees: {
-   *             value() {
-   *               return [
-   *                 {first: 'Bob', last: 'Smith'},
-   *                 {first: 'Sally', last: 'Johnson'},
-   *                 ...
-   *               ];
-   *             }
-   *           }
-   *         };
-   *       }
-   *     }
-   *   < /script>
-   *
    * </dom-module>
    * ```
    *
+   * With the following custom element definition:
+   *
+   * ```js
+   * class EmployeeList extends Polymer.Element {
+   *   static get is() { return 'employee-list'; }
+   *   static get properties() {
+   *     return {
+   *       employees: {
+   *         value() {
+   *           return [
+   *             {first: 'Bob', last: 'Smith'},
+   *             {first: 'Sally', last: 'Johnson'},
+   *             ...
+   *           ];
+   *         }
+   *       }
+   *     };
+   *   }
+   * }
+   * ```
+   *
    * Notifications for changes to items sub-properties will be forwarded to template
    * instances, which will update via the normal structured data notification system.
    *